Cool Workflow について
Cool Workflow（cw）は、リポジトリやドキュメントを対象にコーディングエージェントの作業を記録するコマンドラインツールです。証拠を確認した引用付きレポートを作成し、モデルを実行せずに署名済みの調査結果をオフラインで検証できます。
主な機能
- 01質問を小さなタスクに分割
- 02コード位置の引用付きレポート作成
- 03証拠のない結果を停止
- 04署名済みレポートのオフライン検証
- 05複数のコーディングエージェントに対応
活用シーン
- 01コードレビューの根拠付き結論を保存
- 02署名済み調査結果の改変を確認
- 03中断したワークフローを再開
MCP 対応
MCP サーバーとして実行できると記載されていますが、MCP インターフェースの詳細は示されていません。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
失うチャットの回答ではなく、すべての主張がコードの行に結び付いたレポートを AI エージェントから取得できます。
これは何ですか？
Cool Workflow（cw）は、失いやすく確認しづらい AI コーディングエージェントのチャット回答を、保存可能なレポートに変える小さなコマンドラインツールです。リポジトリやドキュメントのフォルダーを指定すると、次のことができます。
- 作業を計画します。 質問を小さなタスクの集まりに変えます。
- エージェントが作業します。 CW 自体はモデルを実行せず、あなた自身のエージェントが読み取り、考えます。
- 検証済みのレポートを作成します。 すべての主張は、
file.ts:42のようにコード内の実際の場所を示します。根拠のない結果は、そのまま通さずに停止します。
モデルは燃料です。CW はブラックボックスレコーダーであり、ダッシュボードであり、ギアボックスです。エンジンではありません。 モデル API を呼び出すことも、キーを保持することも、コードをアップロードすることもありません。
インストール
npm install -g cool-workflow
または Homebrew でインストール
brew tap coo1white/cool-workflow https://github.com/coo1white/cool-workflow
brew install coo1white/cool-workflow/cool-workflow
cw version
後で brew update && brew upgrade cool-workflow でアップグレードできます。
必要なもの： Node.js v22.13 以降。エージェントをまだお持ちでなくても、以下の手順 1 は実行できます。CW 自体はモデルを実行しません。
エージェントとの連携
| エージェント | フラグ | 状態 |
|---|---|---|
| Claude Code | -claude | ✅ 動作します |
| Codex CLI | -codex | ✅ 動作します |
| Muse Code | -muse | ✅ 動作します |
| OpenCode | -opencode | ✅ 動作します |
| Gemini | -gemini | ✅ opencode 経由で動作します |
| DeepSeek | -deepseek | ✅ opencode または HTTP エンドポイント経由で動作します |
| Cursor | — | ⬜ 未対応 |
| GitHub Copilot CLI | — | ⬜ 未対応 |
| Aider | — | ⬜ 未対応 |
| Qwen Code | — | ⬜ 未対応 |
| Kimi | — | ⬜ 未対応 |
お使いの環境が分からない場合は、cw doctor で設定を確認し、cw fix で問題を解決するコマンドを表示できます。
クイックスタート
1 · 動作を確認する — エージェント不要、30 秒
cw demo tamper
# → builds a real signed ledger, forges it three ways, catches all three offline
# → VERDICT: tamper-evidence holds ✓
2 · コードについて質問する — 1 つのコマンドで
cw -q "How does auth work end-to-end here?"
CW は現在のリポジトリと、PATH 上で最初に見つかったエージェントを使用します。特定のエージェントを使う場合は、上の表にあるフラグ（-claude など）を追加してください。
実際のリポジトリ全体をレビューするには約 4 分かかります（14 個のワーカーを使用し、Map と Assess の各ステージは同時に実行されます）。対象を絞った質問なら、--fast を追加してください。ワーカーを 14 個から 6 個に減らし、エージェントの呼び出し回数を抑えながら、同じ引用付きの回答を得られます。
3 · レポートを開く
実行が終了すると、レポートがブラウザーで自動的に開きます。最初に回答が表示され、その後に根拠が続きます。後からもう一度開くには、次を実行してください。
cw report --open
実例をご覧になりますか？ 実際の実行結果を使った Workbench とレポートを、プッシュのたびに再構築しています：coo1white.github.io/cool-workflow（レポートは /report.html にあります）。
この 3 つの手順が基本の使い方です。それ以外の機能は増やさず、既存のものを使い続けられるようにしています。
レポートを信頼できますか？
CW はモデルを実行するのではなく、記録を管理します。エージェントが調査結果に署名（ed25519）し、cw report verify-bundle は公開鍵だけを使ってオフラインで検証し、署名済みの調査結果がすべて改変されずにレポートに含まれていることを確認します。CW が秘密鍵を保持することはありません。署名するのはエージェントで、CW は検証のみを行います。これにより、署名済みの調査結果が改変されずに届いたことは証明できますが、それ以外の内容が追加されていないことや、何も省かれていないことまでは証明できません。Trust Model をご覧ください。
トラブルシューティング
| 問題 | 解決方法 |
|---|---|
| エージェントが見つからない | cw doctor を実行すると、お使いのマシンにあるエージェントが表示されます |
status: blocked | CW_AGENT_COMMAND=builtin:claude を設定するか、-claude を指定してください |
claude: command not found | Claude Code をインストールして、もう一度実行してください |
| レポートの保存場所がわからない | <repo>/.cw/runs/<id>/report.md にあります。または cw report --open を実行してください |
Missing required input: question | -q "<question>" を追加してください |
| 実行が完了前に停止した | 原因を修正してから cw --resume --run <id> を実行すると、最後まで処理が続行されます。停止したワーカーには、新たな試行が与えられます（プロジェクト内で実行するか、--repo <path> を追加してください） |
... is not a git project | プロジェクト内で実行するか、--repo を指定してください |
Run <id> was made for <folder> | この実行は別のフォルダーに属しています（リポジトリがコピーまたは移動されています）。--repo <that folder> を指定するか、cw run export と cw run import を使って移動してください |
詳細情報
CW は自らのリリースでドッグフーディングを行っています。リリースのたびに、このリポジトリに対して release-cut を実行します。
ライセンス
BSD-2-Clause。COOLWHITE LLC が開発しています。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。