WorkFlow Companion

WorkFlow Companion

このリポジトリは、WorkFlow Companion のホームです。ソース（src/index.js、MIT ライセンス）、Releases ページからのダウンロード（Claude Desktop 用の WorkFlow.mcpb）、バグ報告やリクエスト（Issues）があります。 パッケージ自体は npm からインストールします。Mac では、代わりにオープンソースの workflow-agent-bridge を使用してください。 Claude 用の Opticell の無料ツールはすべてこちらです：opticell-mcp。

Windows または Linux の Claude で、WorkFlow のタスク、メモ、プロジェクトを操作できます。キューの確認、スレッドへの返信、チェックリストへのチェック、メモの記録、ドキュメントの更新が可能です。Claude Code、Claude Desktop、または任意の MCP クライアントで動作します。

無料です。実際の処理を行う iPhone、iPad、または Mac に WorkFlow 5.2 以降が必要です。Mac は必要ありません：

Claude ──MCP──▶ companion ──▶ your private iCloud ──▶ WorkFlow on your iPhone, iPad or Mac
                                                  ◀── receipt + fresh snapshot

コンパニオンが WorkFlow のデータを直接編集することはありません。ユーザー専用のプライベートな iCloud データベース内の領域にコマンドを残します。WorkFlow はアプリと同じチェック（読み取り専用トライアルの制限、メールの許可、エージェントの署名）を適用し、すべてのコマンドを Command History に一覧表示します。Opticell のサーバーを経由するものはありません。

応答するデバイス。 WorkFlow を起動した Mac は、数秒以内に応答します。iPhone または iPad は、iOS が WorkFlow の実行を許可したときに応答します。通常は数分以内ですが、次にアプリを開くまで応答しないこともあり、アプリスイッチャーで WorkFlow をスワイプして終了した状態では応答しません。両方をオンにしている場合、Mac が起動中に応答し、iPhone は待機します。何台のデバイスがオンになっていても、各コマンドは正確に 1 回だけ適用されます。

インストール

1 行で、必要に応じて Node.js をインストールし、このコンピューターにサインインして、Claude Code にコンパニオンを追加し、コンパニオンが自動で作業を開始するように設定できます。

Windows（PowerShell）：

irm https://raw.githubusercontent.com/TeamDzX/workflow-companion/main/install.ps1 | iex

Mac または Linux（ターミナル）：

curl -fsSL https://raw.githubusercontent.com/TeamDzX/workflow-companion/main/install.sh | sh

まず WorkFlow でコンパニオンをオンにしてください（下記の手順 1）。以下の手順はインストーラーが行う内容です。手動で行う場合は参照してください。

セットアップ

1. iPhone または iPad の WorkFlow で、Settings → Windows Companion → Answer the Companion を選択します。Mac の場合は、Settings → Agent Bridge を選択し、Agent Bridge と Cloud Bridge のスイッチをオンにします。

2. node -v でバージョンが表示されない場合は、Node.js 18 以降（LTS）をインストールします。Windows では winget install OpenJS.NodeJS.LTS -e、Mac では brew install node、Linux ではパッケージマネージャー、または https://nodejs.org のインストーラーを使用します。その後、ターミナルを閉じて開き直し（Claude Code も再起動して）、node と npx が見つかるようにします。そうしないと、「node is not recognized」と表示されます。

3. 通常のターミナルウィンドウで、次を実行します：

   npx -y @opticell/workflow-companion@latest setup
   

   https://companion.opticell-limited.com が開くので、iPhone または Mac で WorkFlow が使用している Apple Account でサインインし、そのページに表示されるトークンを貼り付けます。質問に答える必要があるため、Claude Code の ! プロンプトや、その他の非対話型シェルからは実行できません。その場合は、--web-token <token> と --name <name> を渡してください。

4. Claude に追加します：

   claude mcp add --scope user workflow -- npx -y @opticell/workflow-companion@latest
   

   Windows では npx はスクリプトのため、Claude Code では先頭に cmd /c が必要です：

   claude mcp add --scope user workflow -- cmd /c npx -y @opticell/workflow-companion@latest
   

   --scope user を指定すると、このコンピューター上のすべてのプロジェクトで使用できます。

   Claude Desktop ではターミナルは不要です。製品ページから WorkFlow.mcpb をダウンロードし、ダブルクリックします。その後、https://companion.opticell-limited.com でサインインし、Settings → Extensions → WorkFlow Companion → Sign-in token にトークンを貼り付けます。

npx -y @opticell/workflow-companion status を実行すると、いつでも状態を確認できます。

名前

セットアップでは、このコンピューター上の Claude を WorkFlow で何と呼ぶかを尋ねます （選択しない場合は「Companion」です。たとえば --name Server のように指定できます）。この名前を使うことで、Mac 自身の Claude ではなく、こちらに作業を依頼できます。

• この名前にタスクを割り当てます。コンパニオンから応答があると、WorkFlow にその名前が表示され、「質問」シートで選択できるようになります。
• コメントやメモに @Server と記入します。共有プロジェクトのスレッドでのメンションは対象になりません。他の人もそこに書き込めるためです。
• コンパニオンの返信には名前が署名されるため、どの Claude が何をしたかスレッドで確認できます。
• **1 つの名前を使えるコンピューターは 1 台だけです。**セットアップ時に、別のコンピューターがすでに応答している名前は拒否され、別の名前を求められます。すべてのコマンドでも同様に確認されます。名前を設定する Claude Desktop も対象です。このコンピューターを別のコンピューターの代わりに使う場合は、setup --takeover を使用してください。コンピューターが 2 週間応答しないと、名前は自動的に再び使えるようになります。
• @Claude は常に Mac 上の Claude を指します。コンパニオンにこの名前を付けることはできません。また、メンションは単語全体にだけ一致するため、@Claude2 で Mac が起動することはありません。

Claude Desktop ユーザーは、拡張機能の設定で名前を指定します。

自動で作業する

起動機能を有効にすると、アプリから @Server とメンションするだけで依頼できます。このコンピューターの前に誰もいる必要はありません。Claude Code をインストールして、ここでサインインしたら、次のコマンドで有効にします。

npx -y @opticell/workflow-companion wake-on

• 2 分ごとに、非表示のスケジュール済みジョブ（Windows ではタスク スケジューラ、それ以外では cron）が、iCloud 内のこの名前のキューを確認します。これは小さな呼び出し 1 回で済み、タスクリストは変更があった場合にのみダウンロードされます。
• 新しい作業があると、Claude Code のセッションが 1 つ開始されます（claude -p、ウィンドウなし）。タスクを読み取り、着手したことをコメントに投稿し（スマートフォンには「Server is on it」と表示されます）、作業を行ってスレッドで返信します。
• **新しい作業として扱われるもの：**名前に新しく割り当てられたタスク、ユーザーからの新しい @Server コメント、割り当て済みタスクへのユーザーからの追加依頼、またはその名前へのメンションを含む編集済みメモです。コンパニオン自身の返信では起動しません。
• **処理は 1 回だけです。**同時に実行されるセッションは 1 つです。処理済みの作業が再び開始されることはありません。セッション自体を開始できなかった場合（Claude にサインインしていない、使用制限に達したなど）は、さらに 2 回再試行し、その後スレッドにその旨を投稿します。
• 実行時間の上限はデフォルトで 45 分です（--max-minutes）。上限によって停止されたセッションは、スレッドにその旨を投稿します。
• **実行できる操作：**デフォルトでは WorkFlow ツール（mcp__workflow）のみを使用できます。タスクの読み取りと返信が可能です。このコンピューターでコマンドを実行させるには、--allow-tools "mcp__workflow Bash Read" を渡します（Claude Code の任意の権限ルールを指定できます）。WorkFlow で @Server と書き込める人は誰でもこのコンピューターでコマンドを実行できるようになるため、よく検討してから有効にしてください。共有プロジェクトからコンパニオンが起動することはありません。
• **Windows：**通常、スケジュールされたタスクはユーザーがログインしている間のみ実行されます。ログアウト中も実行するには、タスク スケジューラで「WorkFlow Companion wake」タスクを「ユーザーがログオンしているかどうかにかかわらず実行する」に変更します。
• --workdir でセッションを開始するフォルダーを指定します（指定しない場合はホームフォルダー）。--model で Claude モデルを、見つからない場合は --claude で Claude Code のパスを指定します。--skip-existing を指定すると、すでにキューにある項目を処理済みとして扱います。
• ログは ~/.workflow-companion/wake.log にあります。wake-off ですべて停止します。

最新の状態を維持する

• Claude Code は、登録名のコマンドを実行します。@latest を指定して登録すると（セットアップ時に正確な行が表示されます）、新しいセッションでは毎回最新リリースが使われます。
• スケジュール済みジョブ（キープアライブ、起動）は保存されたコピーを実行するため、npm の影響を受けず、自動で更新されます。6 時間に 1 回以上の頻度で、npm のパッケージ情報（registry.npmjs.org/@opticell/workflow-companion/latest）を確認します。新しいバージョンがある場合、リリースをダウンロードし、npm の sha512 チェックサムと照合して、Node で解析できることを確認してから差し替えます。auto-update off で自動更新を無効にし、update で手動更新できます。
• バージョンが報告されます。 実行中は 10 分ごとを目安に、各コンパニオンがバージョン、コンピューター、チェックイン時刻を iCloud に書き込みます。WorkFlow 5.3.2 では、Settings → Agent Bridge → Who's Bridged に表示され、status では各コンパニオンのバージョンが一覧表示されます。

コマンド

workflow-companion	MCP サーバーを実行します。Claude が起動するコマンドです。
workflow-companion setup	このコンピューターをサインインします。--web-token を指定するとプロンプトを省略できます。
workflow-companion status	どのデバイスが応答しているか、スナップショットがどのくらい新しいか、遅れて到着したレシートがあるかを表示します。
workflow-companion doctor	このコンピューターの状態をすべて確認し、問題の修正方法を示します。何かが動作しない場合は、ここから始めてください。
workflow-companion canary	毎日のセルフテストを今すぐ実行します。canary on|off、canary at HH:MM。
workflow-companion keepalive	サインインを更新します。スケジュール済みジョブがこれを実行します。
workflow-companion update	スケジュール済みジョブのコピーを今すぐ最新リリースに更新し、Claude Code を @latest に設定する方法を表示します。
workflow-companion auto-update on|off	スケジュール済みジョブが自動更新するかどうかを設定します（デフォルトはオン）。
workflow-companion wake-on	この名前宛ての作業が届くと、Claude Code セッションを自動で開始します。上記を参照してください。
workflow-companion wake-off	自動開始を停止します。ここで Claude に依頼するまで、作業は待機します。
workflow-companion wake	キューを 1 回確認します。スケジュール済みジョブがこれを実行します。
workflow-companion monitor add|list|check|remove	Claude を使わずに、このコンピューターが稼働しているか確認します。下記を参照してください。
workflow-companion approvals on|off	「approve CODE」と返信すると、アシスタントが指定されたコマンドを 1 つ実行できるようにします（デフォルトはオフ）。
workflow-companion inbox-on|inbox-off	フォルダーに入れたファイルをタスクにします。
workflow-companion notifications on|off	このコンピューターで通知を表示します（デフォルトはオン）。notify-test でテスト通知を表示します。
workflow-companion reports on|off	各セッションの後、タスクに短いレポートを添付します（デフォルトはオン）。
workflow-companion signout	サインイン情報、キャッシュデータ、2 つのスケジュール済みジョブを削除します。

このコンピューター単独で実行（1.8）

これらは起床処理と同じ2分間隔のスケジュールジョブで実行され、Claude の利用量は消費しません。

モニター。 何かに変化があった場合にのみ Claude を起こします。

workflow-companion monitor add --name site --http https://example.com --task "Server status" --wake
workflow-companion monitor add --name disk --disk C:\ --min-gb 20 --task "Server status"
workflow-companion monitor add --name api --port 10.0.0.5:443 --every 2
workflow-companion monitor add --name backup --file D:\backups\latest.zip --task "Backups"
workflow-companion monitor add --name nightly --command "check-backups.cmd" --task "Backups" --wake

変化（停止、復旧、ファイルの変更）があるとタスクに投稿され、ここに通知が表示されます。また、--wake を指定すると、その内容に関するセッションが開始されます。アシスタントはウェブサイト、ポート、ディスク、プロセス、ファイルのモニターを自分で設定できます（workflow_monitor）。ただし、コマンドモニターを追加できるのはあなただけです。数分おきにコマンドを実行するためです。

承認。 アシスタントは、このコンピューターで特定のコマンドを1回実行するよう依頼できます（サービスの再起動、アップデートのインストールなど）。コマンドはコードとともにタスクに投稿されます。スマートフォンから approve K7Q2（または decline K7Q2）と返信してください。人による返信だけが有効で、別のアシスタントによる返信は無効です。共有プロジェクトのタスクからは依頼できません。コマンドは表示されたとおりに1回だけ、24時間以内に実行されます。このコンピューターで workflow-companion approvals on を実行するまで無効です。

受信トレイフォルダー。 workflow-companion inbox-on を実行すると、~/WorkFlow Inbox（または --folder で指定したフォルダー）が作成されます。ファイルを入れると、そのファイルが添付されたタスクになります。プロジェクト名のサブフォルダーに入れると、そのプロジェクトに振り分けられます。振り分けられたファイルは Filed/<date> に移動します。--assign を指定すると、このアシスタントのキューに入ります。

通知。 作業の到着、モニターの変化、承認への返信、セッションで対応が必要になった場合、または iCloud のサインインが終了した場合に、このコンピューターに通知が表示されます。iCloud のサインインが終了した場合は、解決するためのコマンドも表示されます。

毎日のセルフテスト（1.9）。 起床処理が有効な場合、コンパニオンは1日1回（07:30、または canary at HH:MM で指定した時刻）、一連の処理が引き続き正常に動作することを確認します。WorkFlow がコマンドを適用し、Claude Code が実行されて書き込みを行い、その変更が戻ってくることを検証します。成功すると「⚙︎ daily self-test」タスクがひそかに更新されます。失敗した場合は、該当箇所に失敗した手順と修正方法がコメントされ、その内容がスマートフォンに届きます。workflow-companion canary を実行すると、今すぐテストを実行できます。canary off を実行すると停止します。

セッションレポート。 何らかの変更を行った各セッションの後に、依頼された内容、変更内容、実行した承認済みコマンド、最後の発言をまとめた短いレポートがタスクに添付されます。

知っておくとよいこと

• 応答するデバイスが必要です。 何も応答していない間に送信したコマンドは iCloud で待機し、WorkFlow が次に確認したときに実行されます。ツールがその旨を伝え、実行結果は後で workflow_state に表示されます。
• 読み取りはスナップショットから行われます。 WorkFlow は変更後、数秒してからスナップショットを公開するため、書き込み直後の読み取りにはわずかな遅れが生じることがあります。
• ファイルはお使いの iCloud を経由します（1.6）。 ファイルを添付する、ドキュメントをプロジェクトに格納する、または新しいバージョンを追加すると、ファイルはご自身の iCloud にアップロードされます。応答する Mac または iPhone 上の WorkFlow 5.3 以降がファイルを添付し、アップロードしたコピーを削除します。ファイルあたり最大 50 MB です。古いバージョンの WorkFlow はアップロードを無視し、ファイルが見つからないと報告します。
• 再び戻すこともできます（2.2）。 workflow_download はドキュメントのファイルをこのコンピューターに保存し（デフォルト：ホームフォルダー内の Downloads/WorkFlow）、SHA-256 を検証して、既存のファイルを上書きしません。応答する Mac または iPhone で WorkFlow 5.6.1 以降が必要です。ファイルは取得されるまでの間、最長 1 時間だけ iCloud で待機します。
• 毎日のアシスタント（2.2）。 WorkFlow → Settings → Agent Bridge → Briefs, Check-ins & Approvals でこのコンパニオンを選ぶと、wake ジョブが朝のブリーフを作成し、静かな時間帯以外は数時間ごとに状況を確認します。新しい対応事項がある場合にのみセッションを開始します。WorkFlow 5.6 が必要です。
• トークンはパスワードです。 ~/.workflow-companion/token.txt は、iCloud 上の WorkFlow データを開くために使われます。Apple はリクエストのたびにトークンを更新し、コンパニオンは更新されたトークンをその都度保存します。同じコンピューター上の複数の Claude セッションで共有できます。交代で使用します。別のマシンにコピーしないでください。各コンピューターで、それぞれ setup を実行してください。
• 接続の維持。 Apple は、サインイン状態を使用しないままにすると、9～14 時間の間にセッションを終了します。Claude の実行中は、コンパニオンが 2 時間ごとにセッションを更新します。setup を実行すると、workflow-companion keepalive も 3 時間ごとに実行されるようスケジュールされます。Windows ではタスク スケジューラ（コンソールウィンドウを表示せずに実行）、それ以外では cron が使われます。signout を実行するとスケジュールが削除され、--no-schedule を指定するとスケジュールが省略されます。
• **「再度サインインしてください」**は、たとえばコンピューターの電源が長時間切れていた後などに、Apple がセッションを終了したことを意味します（HTTP 401/421）。もう一度 setup を実行してください。

ツール

18 個のツールがあります（2.0 で以前の 37 個を統合しました。旧名で呼び出しても引き続き動作します）。

ツール	機能
workflow_queue	ユーザーの基本ルールに沿って整理された受信トレイ
workflow_list	タスク、メモ、プロジェクト、ドキュメント、または最近のコメントを検索付きで一覧表示
workflow_get	1 件のタスク、メモ、またはドキュメントの全内容を取得
workflow_create_task	タグ、サブタスク、最初のコメントも含めて作成
workflow_update_task	1 回の呼び出しでフィールド、固定ステータス行、チェックリストを更新
workflow_comment	タスクに返信するか、別のアシスタントまたは担当者に引き継ぐ
workflow_note	メモ帳のメモを作成、返信、または変換
workflow_create_project	プロジェクトを作成または更新
workflow_attach	ファイルをタスクに添付、プロジェクトに格納、またはドキュメントの新しいバージョンとして追加
workflow_update_document	ドキュメントのプロフィールまたはフォルダーを更新
workflow_draft_email	ユーザーが確認して送信するメールの下書きを作成
workflow_watch	後でタスクについて通知を受ける
workflow_monitor	ウェブサイト、ポート、ディスク、プロセス、またはファイルを監視し、変化があったときに通知
workflow_approval	コマンドの承認を依頼、確認、実行
workflow_state	ブリッジが機能しているか確認。check: ping または doctor を指定
workflow_propose	ユーザーが適用または却下できる変更を提案（WorkFlow 5.6）
workflow_brief	毎日のアシスタント向けに朝のブリーフを作成（WorkFlow 5.6）
workflow_download	ドキュメントのファイルをこのコンピューターに保存（WorkFlow 5.6.1）

© Opticell Limited · https://www.opticell-limited.com/companion

ソースとライセンス

src/index.js がサーバー全体です。ファイルは1つで、Node 18以降を使用し、依存関係はありません。MITライセンスです（LICENSE を参照）。公開されている npm パッケージは同じファイルで、ビルド時に WorkFlow の CloudKit API トークンが埋め込まれています（このトークンは秘密情報ではなく、サインイン済みのユーザーが自分のデータにアクセスするためだけに使われます）。ソースから実行する場合、setup が --api-token を使ってトークンを尋ねます。

Dockerfile は stdio 経由でサーバーを実行します。MCP ディレクトリではこれを使って、サインインしなくてもサーバーが起動し、ツールの一覧を表示できることを確認します。