CLI Doctor

エージェントCLIが起動時に落ちた。
その理由を、正確に。

エージェントCLIが起動しない。これはAIコーディングで最も気力を削がれる失敗です:出力なし、スタックトレースなし、ときにはプロンプトが戻ってくるだけ。CLI Doctorはその瞬間を捉え、実際に何が起きたのかを読み取り、唯一重要な問いに答えます:何が壊れたのか、そして今どうすればいいのか。

CLI Doctorは、AgentsRoomが実行した正確なコマンド、どのフラグがどの設定から来たのか、そしてCLIが諦める前に何を出力したのかを把握しています。検索結果には決してない文脈です。

CLI Doctor
起動に失敗
$ claude --model opus-5 --mcp-debug
error: unknown option '--mcp-debug'

失敗した起動、実際のエラー、そして原因となった設定を名指しする診断。

エージェントCLIは変化が速いものです。マイナーリリースでフラグが削除され、Nodeのアップグレード後にバイナリがPATHから消え、ログインの有効期限が切れ、サンドボックスが起動を拒否し、別のツール向けに書かれた設定ファイルが読み込まれる。あなたの側で起きることはいつも同じです:プロンプトを送っても、何も起きない。

難しいのは修正そのものではありません。起動コマンドに並ぶ20個のうち、どれが壊れた原因なのか、そしてそれがアプリから来たのか、プロバイダーの設定から来たのか、3週間前にそのエージェントだけに設定した上書きから来たのか、それともCLI自体が知らないうちに変わったのかを知ることです。

CLI Doctorはその溝を埋めます。実際に起動されたコマンドを記録し、すべてのフラグにそれを注入した設定のタグを付け、CLIが出力した内容を取り込み、それらを具体的な手順付きの短い診断に変えます。確定的なチェックが常に先に走り、優先されます:AIが口を開くのは、アプリが自力で答えられないときだけです。

何も出ないターミナルの代わりに得られるもの

解読すべきスタックトレースではなく、何が失敗したのかを平易な言葉でまとめた要約。実際の原因を名指しする1、2文です。

順番に並んだ具体的な次の手順。各手順には、該当する設定パネル、再インストールのコマンド、再起動へのショートカットを付けられるので、どこに設定があるのかを探し回る必要はありません。

フラグの出所:起動コマンドのすべてのトークンが、その出どころに紐づけられます。だから答えは推測ではなく、「このフラグは設定の自律モードから来ています」と言えます。

開発コマンドにも同じ扱いを。ビルド、テスト、サーバーのコマンドがターミナルで失敗したときも、診断はワンクリックで開けます。そこからそのままDevOpsエージェントに丸ごと引き渡すこともできます。

診断が生まれるまで

意図的な多層構造:安くて確実なチェックが先に走り、AIは最後の手段です。

01

AgentsRoomが実際の起動を記録する

ターミナルが生成されるその一点で、コマンド全体が記録されます:バイナリ、フラグ、モデル、オプション。この記録が、あとで正確な診断を可能にします。対象はエージェントが起動しうるすべての経路で、スマホやバックログのチケットから起動した場合も含みます。

02

確定的なチェックが先に答える

バイナリの欠落、CLIがもう受け付けないフラグ、ログインしていないセッション、古すぎるバージョン:これらは既知で確実な判定です。バナーと修正ボタンで直接答えます。AI呼び出しなし、待ち時間なし。

03

疑わしい起動は、決めつけずに裏付ける

既知のケースに当てはまらない場合、AgentsRoomは最初の数秒でエラーのパターンを探し、次にターミナルで実際に何が動いているかを確認します。起動が遅いだけのCLIや、初回実行でMCPサーバーをインストール中のCLIは失敗ではないので、除外されます。

04

秘匿処理された文脈を診断する

そこで初めてAIが登場します。渡されるのはエラーの抜粋、サニタイズしたコマンド、フラグの出所マップです。システムプロンプト、秘密情報らしき値、引用符で囲まれた長い引数は、何かが送信される前にあなたのマシン上で秘匿処理されます。

05

要約と手順を受け取り、決めるのはあなた

診断はターミナルに表示されます。勝手に何かが実行されることはありません:アクションボタンは該当する設定を開き、再起動を提案し、インストールコマンドを表示するだけで、押すのは常にあなたです。

答えはどこから来るのか

CLI Doctorは、あなたが設定するのと同じ場所を読みます。起動失敗の大半を生むのは、この3つです。

当然の制限を前提に作られています

外に出る前に秘匿処理
システムプロンプト、秘密情報らしき環境変数の値、引用符で囲まれた長い引数は、診断のリクエストが送られる前に、あなたのマシン上で取り除かれます。
勝手に実行はしません
診断は、設定パネルを開く、エージェントを再起動する、インストールコマンドを表示する、といった提案をします。自分でコマンドを実行することはありません。
確かな答えは、確かなまま
バイナリの欠落や拒否されたフラグには、モデルではなく確定的なチェックが答えます。AIが口を開くのは、確かなことが本当に何も言えないときだけです。

FAQ

CLI DoctorはどのエージェントCLIに対応していますか?

すべてです。起動記録は、AgentsRoomがターミナルを生成する唯一の地点で書き込まれます。したがってClaude Code、Codex CLI、GitHub Copilot CLI、Antigravity CLI、OpenCode、Aider、Grok Build、Mistral Vibe、Kimi Codeがすべて対象で、モバイルコンパニオンやバックログのチケットから起動したエージェントも含まれます。

ターミナルの出力をサーバーに送るのですか?

送るのは、秘匿処理した起動エラーの抜粋、サニタイズした起動コマンド、フラグの出所マップだけで、しかも実際に診断を行うときだけです。システムプロンプト、秘密情報らしき環境変数の値、引用符で囲まれた長い引数は、まずあなたのマシン上で取り除かれます。ソースコードが含まれることは一切なく、自動診断は設定の「プライバシーとデータ」で完全にオフにできます。

勝手にコマンドを実行したり、設定を変えたりしますか?

いいえ。手順には、該当する設定パネルを開く、エージェントの再起動を提案する、コピー用のインストールコマンドを表示する、といったショートカットが付くことがあります。何かを実行するのは、常にあなたの操作です。

フラグの出所とは、具体的に何ですか?

AgentsRoomは複数の層から起動コマンドを組み立てます:プロバイダーのデフォルト、自律モード、選んだモデル、推論の強度、エージェントごとのCLI上書きなどです。フラグの出所は、最終的なコマンドの各トークンに、それを置いた層のタグを付けます。だから診断はフラグを抽象的に説明するのではなく、切り替えるべきスイッチそのものを指し示せます。

すべてのエラーで発火するのですか?

いいえ、これは意図的です。エージェントのターミナルでは、起動失敗のエピソード1回につき1度だけ、しかも失敗が裏付けられたときにだけ発火します:起動が遅いだけのCLIや、初回実行でMCPサーバーをインストール中のCLIは、診断せずに除外されます。開発コマンドのターミナルでは、失敗し続けるwatchループがエラーを出し続けるため、診断はクリックしたときだけ行われます。

無料プランでも使えますか?

はい、月ごとの上限付きで使えます。Plusでは上限が上がり、Proは実質無制限です。バイナリの欠落や拒否されたフラグなど、最も多い失敗をカバーする確定的な判定は、そもそもカウントされません:モデルを呼ばないからです。

SSH経由でリモートマシン上のエージェントを動かしている場合はどうなりますか?

こちら側の前景プロセスはSSHクライアント自身なので、リモートのCLIが落ちてもここからは正常に見え、そのエピソードはスキップされます。これは意図的なトレードオフです:自信たっぷりに間違えるくらいなら、診断を見逃すほうがましだからです。確定的なチェックは、接続の先のリモート側でも引き続き機能します。

エラーをチャットボットに貼り付けるのと何が違いますか?

チャットボットが見られるのは、あなたが貼り付けたメッセージだけです。CLI Doctorはそれに加えて、実際に実行されたコマンド、その中の各フラグの出所、使用中のプロバイダーとモデル、プロセスの状態を持っています。しかも、あなたが何かを組み立てる必要はありません。その文脈こそが、一般論の回答を「変更すべき設定の名前」に変えます。

こちらもおすすめ

マルチプロバイダー

AgentsRoomは9つのAIコーディングプロバイダーをサポート:Claude、Codex、GitHub Copilot CLI、OpenCode、Antigravity CLI、Aider、Grok Build、Mistral Vibe、Kimi Code。エージェントごとに異なるプロバイダーを割り当て、会話中にプロバイダーを切り替え、自動ハンドオフでコンテキストを保持。最良のマルチプロバイダーAIコーディングツールです。

ステータス追跡

各Claude Codeエージェントのステータスを一目で確認できます。思考中、完了、アイドル、入力待ちの各状態を色分けしたインジケーターで表示。経過タイマー、アクティビティサマリー、プロジェクト単位のカウンター。

Dev Terminals

ビルド、テスト、開発サーバーをエージェントと同じウィンドウで実行。長いコマンドが終わればベルが鳴り、失敗すれば診断が出ます。

エージェントとターミナルを復元

アプリを開き直せば、エージェントと開発ターミナルは中断したそのままの場所に。前回のCLIの会話を再開するオプションもあります。

AIコミットメッセージ

AgentsRoomに組み込まれたAIコミットメッセージジェネレーター。コミットフィールドのスパークルをクリックすると、実際のgit diffを読み取り、Conventional Commits形式でクリーンなコミットメッセージを1つ書きます。粗いドラフトを入力し、書き直してもらいましょう。チームのフォーマットルールはすべての生成に適用されます。

エージェント提案

どのAIエージェントを使用すべきか分からない?タスクを平易な言葉で説明すると、AgentsRoomが適切なエージェントを提案します:あなたの部屋から、14の組み込みロールまたは260以上のカタログ専門家から、一行の理由とともに。ワンクリックでタスクが割り当てられます。

エージェントが起動しない理由を推測するのはやめよう

AgentsRoomが起動を読み取り、原因を名指しし、直し方を渡します。macOS、Windows、Linuxで無料ダウンロード。

無料AgentsRoomをダウンロード

コンパニオンアプリ:外出先でもエージェントを確認

Claude、Codex、Antigravity CLI、またはその他の AI プロバイダーを使用します。

拡張機能を入手
Chrome Web Store

バグや要望を公開バックログに直接送信できます。

実際の AgentsRoom の様子。

マルチプロジェクト
マルチプロバイダー
マルチエージェント
ライブステータス
ファイル差分
モバイルアプリ
ライブプレビュー
エージェントチーム
ブラウザテスト
バックログ駆動開発
プロンプトライブラリ
スキルライブラリ
すべての機能を見る