CLI エージェント
CLI エージェントは、ADHDev の主要なワークフローの 1 つです。現在 ADHDev はカタログに 8 個の組み込み CLI プロバイダー を提供しています。プロバイダーが有効化され、対象マシンで検出された後、デーモンの PTY/session-host レイヤーを通じて実行されるため、ターミナル出力を見たり、ダッシュボードから入力したり、デスクトップやモバイルからセッションを進め続けたりできます。
WARNING
組み込みであることは、検証済みのサポートを意味しません。プロバイダーが互換性ドキュメントで明示的に格上げされていない限り、未検証として扱ってください。検証ステータスは現在全面的な再検証中です — 対応プロバイダー を参照してください。
組み込み CLI プロバイダー
| エージェント | コマンド | 検証レベル | 説明 |
|---|---|---|---|
| Antigravity CLI | adhdev launch antigravity-cli | 未検証 | Google の Antigravity ターミナルエージェント |
| Claude Code | adhdev launch claude | 未検証 | Anthropic の Claude コーディングエージェント |
| Codex CLI | adhdev launch codex-cli | 未検証 | OpenAI の Codex ターミナルエージェント |
| Cursor CLI | adhdev launch cursor-cli | 未検証 | Cursor のターミナルエージェントワークフロー |
| Grok CLI | adhdev launch grok-cli | 未検証 | xAI の Grok ターミナルエージェント |
| Kimi | adhdev launch kimi | 未検証 | Moonshot の Kimi コーディングエージェント |
| OpenCode CLI | adhdev launch opencode | 未検証 | オープンソースのターミナルコーディングエージェント |
この表にない CLI エージェントを使いたい場合は、プロバイダーマニフェストで 自分で追加する方法を カスタムプロバイダー で確認してください。
CLI が重要な理由
CLI エージェントは、しばしば作業を進め続ける最速の方法です。その理由:
- リポジトリとシェルのワークフローに近い状態を保つ
- リモートターミナル制御でうまく動作する
- IDE 固有の UI の破損を避ける
- ADHDev が再構成された抽象ではなく、正確なターミナルセッションをストリーミングできる
今日、最も信頼できるリモートワークフローが欲しいなら、CLI エージェントが通常最初に検証すべき経路です。個々のプロバイダーの検証ステータスは現在再検証中です — 特定の格上げに依存する前に 対応プロバイダー で現在の状態を確認してください。
CLI エージェントの起動
# Strong default paths
adhdev daemon
adhdev launch claude
adhdev launch codex-cli
adhdev launch cursor-cli
# Additional built-in CLI providers
adhdev launch antigravity-cli
adhdev launch grok-cli
adhdev launch kimi
adhdev launch opencode起動前に、マシンの Providers タブでプロバイダーが有効化されているか、構成された実行ファイルに対して Detect が成功するかを確認してください。バイナリがデフォルトの PATH の外にある場合は、まずカスタムの実行ファイルパス/引数を設定してください。
デーモンが PTY で CLI プロセスをスポーンし、出力をダッシュボードにストリーミングし、あなたの入力をプロセスに転送します。
通常の起動は新しいセッションとして扱われます。連続性が欲しい場合は、暗黙の自動再開に頼るのではなく、History やホスト型ランタイムの復旧のような明示的な再開経路を使ってください。
WARNING
各 CLI ツールは自身の認証を処理します。ADHDev は PTY セッションとリモート制御レイヤーを管理し、アップストリームツールのログインフローは管理しません。
フォルダー信頼の事前付与
kimi、grok-cli、codex-cli、claude-cli、antigravity-cli は、フォルダー信頼スキームを ADHDev に登録します。そのため、新しいディレクトリでの新規起動は、そのツールの一度限りの「このフォルダーを信頼しますか？」プロンプトで止まることなくスキップされます。信頼は、あなたが対話的に承認したときにツール自身が書き込むのと同じ信頼ストアを使って、事前に付与されます。
ターミナルワークフロー
ADHDev の CLI プロバイダーは、現在ターミナルビューを主要なワークフローとして使用します。つまり、ターミナルが次の信頼の拠り所です:
- 出力と進捗
- 承認プロンプト
- ツール実行フロー
- 再接続とスクロールバックの挙動
ターミナルビュー
CLI エージェントは、xterm.js で動作する完全なインタラクティブターミナルとともにダッシュボードに表示されます:
- 完全な TUI レンダリング — 色、カーソル移動、プログレスバー、承認プロンプト
- リモート入力 — ダッシュボードから直接入力
- スクロールバックの復元 — 再接続後に PTY バッファが再生されます
- モバイルフレンドリーな制御 — すばやい承認や軽量な監督に実用的
セッションの復旧
CLI ランタイムは、もはや使い捨ての一回限りの起動としては扱われません。ADHDev はホスト型ランタイムレイヤーを維持しており、切断やデーモンの再起動の後でもセッションを復旧できる場合が多いです。
その復旧経路はオペレーター主導です: 連続性が欲しいとき、ユーザーは Resume / History / ホスト型ランタイムの復旧アクションを明示的に選ぶべきです。通常の新規起動が、静かに古いセッションを再度開くべきではありません。
CLI セッションがメインダッシュボードから消えた場合は、次を確認してください:
- 非表示タブ
- アクティビティインボックス
- History
- マシンの Hosted Runtimes タブ
コマンドラインでの復旧には、まず主要なユーザー向けのランタイムサーフェスから始めてください:
adhdev runtime list
adhdev runtime attach <runtimeTarget>
adhdev runtime recover <runtimeTarget>
adhdev runtime restart <runtimeTarget>
adhdev runtime snapshot <runtimeTarget><runtimeTarget> は、セッション ID、ランタイムキー、表示名、または adhdev runtime list に表示される一意のプレフィックスを受け付けます。
一般的な経路でより短いコマンドを好む場合は、adhdev attach <runtimeTarget> と adhdev recover|resume <runtimeTarget> が同じランタイムサーフェスへの直接のショートカットです。
低レベルの診断や明示的なオペレーター制御が必要な場合は、次を使用してください:
adhdev daemon:session-host
adhdev daemon:session-host --session <sessionId> --resume
adhdev daemon:session-host --session <sessionId> --restart
adhdev daemon:session-host --prune-duplicatesこれは、ランタイムはまだ存在しているのに、アクティブなダッシュボードセッションが詰まっていたり、間違ったコピーに接続されていたりする場合に適した経路です。
History と再開の深さは、依然としてプロバイダーによって異なります。組み込み CLI がきれいに起動できても、その経路が明示的にテストされるまでは、再開フローについては 未検証 のままになることがあります。
エージェント設定
各 CLI エージェントは、ダッシュボードの歯車ボタンから設定を構成できます:
| 設定 | 説明 |
|---|---|
| 通知 | 状態変化の通知を表示 |
| 自動承認 | サポートされている場合、ツール実行を自動承認 |
| 承認アラート | 承認が必要なときに通知 |
| 進捗なしアラート | ターンが長く進捗を示さないときに警告（旧称「長時間生成アラート」） |
| 進捗なししきい値 | 進捗なしアラートが発火するまでの秒単位のしきい値 |
自動承認モード（1.0.60+）
上記の単純なオン/オフの「自動承認」トグルに加えて、すべての組み込み CLI プロバイダーは、独自の起動時自動承認モードのセットを宣言するようになりました — これはセッション開始時に表示されるピッカーであり、歯車ボタンの設定ではありません。各モードにはリスクティアが付いているので、起動する前に何を有効にしようとしているかが分かります:
| リスク | 意味 |
|---|---|
| Safe（安全） | 対話的な PTY 解析 — ADHDev は認識したプロンプトに答えます。ツールレベルでのバイパスは一切ありません |
| Caution（注意） | プロバイダー自身の「編集を承諾」/「自動」フラグが起動時に渡されます — より広い自動承諾で、依然としてプロバイダー範囲内です |
| Dangerous（危険） | プロバイダーの完全な権限バイパスフラグ（例: Claude Code の --permission-mode bypassPermissions、kimi の --auto）— エージェントはプロンプトなしでコマンドを実行します。ADHDev は、このモードで起動する前に確認ダイアログを表示します。 |
利用可能なモードはプロバイダーごとに異なり（そのプロバイダー自身の CLI フラグに由来します）、デフォルトは常に安全な対話モードです。
モデル検出（1.0.60+）
モデルピッカーのリストは、プロバイダーによって検出方法が異なります:
| 方法 | プロバイダー |
|---|---|
| 実行時に CLI 自身のモデル一覧コマンドを実行 | codex-cli、grok-cli、cursor-cli、antigravity-cli、opencode |
| プロバイダーのローカル設定ファイルを読み取り | kimi |
claude-cli のモデルオプション（opus/sonnet/haiku/fable）は、バージョン付きのスラッグではなく安定したエイリアスなので、検出されたリストのようにドリフトしません。
クォータレポート
adhdev quota <provider> は、プロバイダーの現在の使用状況の読み取り値を表示します。adhdev quota refresh [providers...] は、実行中のデーモンに対して、アクティブなレート制限クールダウンを尊重しつつ、実際にキャッシュされた読み取り値（ルーティングとダッシュボードが参照するもの）を再取得・更新するよう要求します。
クォータレポートが利用可能なのは: claude-cli、codex-cli、kimi、opencode、grok-cli、cursor-cli、antigravity-cli（組み込み CLI 7 個すべて）です。
トラブルシューティング
エージェントが起動しない
- ツールがローカルにインストールされているか確認
- マシンの Providers タブでプロバイダーを有効化し、Detect を実行
- バイナリがデフォルトの PATH の外にある場合、カスタムの実行ファイルパス/引数を設定
- アップストリームの認証または API キーを確認
adhdev daemon:statusでローカルのヘルスを検査
ターミナルが空白
- ツールが入力を待っている可能性があります
- ダッシュボードで接続ステータスを確認
- 重複セッションを開始する前に、非表示タブ、インボックス、履歴を確認
- ランタイムが生き残っていた場合は、すぐに再起動する代わりに Hosted Runtimes を通じて復旧
ターミナル出力がおかしい
- アップストリームツールがターミナルを不正な状態のままにした場合は、セッションを再起動
- CLI プロバイダーの正規の出力としてターミナルビューを扱う
- 問題が続く場合は、プロバイダーの互換性の問題として扱い、まず互換性ページを確認
承認するものが何もないのに承認プロンプトが表示されるセッション（1.0.60+）
一部の CLI は、ターミナル自体の外側にあるステップでブロックすることがあります — 最も分かりやすい例は grok-cli のブラウザベースのサインインです。ADHDev はこれを内部的に個別の状態として追跡するようになったため、そのようなセッションはアイドルや生成中として静かに読み取られる代わりに、あなたの承認インボックスに現れます（そこでは別バッジではなく、通常のあなた待ちの項目として表示されます）。外部のステップ（例: ブラウザでのサインインを完了する）を済ませると、セッションは通常どおり再開します。