CLI エージェント
CLI エージェントは、ADHDev の主要なワークフローの 1 つです。現在 ADHDev はカタログに 7 個の組み込み CLI プロバイダー を提供しています。プロバイダーが有効化され、対象マシンで検出された後、デーモンの PTY/session-host レイヤーを通じて実行されるため、ターミナル出力を見たり、ダッシュボードから入力したり、デスクトップやモバイルからセッションを進め続けたりできます。
Aider、Gemini CLI、GitHub Copilot CLI、Goose などのエージェントは、組み込み CLI プロバイダーではありません — 代わりに Agent Client Protocol（stdio）で接続します。それらのエージェントについては ACP エージェントガイドを参照してください。
WARNING
組み込みであることは、検証済みのサポートを意味しません。プロバイダーが互換性ドキュメントで明示的に格上げされていない限り、未検証として扱ってください。
組み込み CLI プロバイダー
| エージェント | コマンド | 検証レベル | 説明 |
|---|---|---|---|
| Antigravity CLI | adhdev launch antigravity-cli | 未検証 | Google の Antigravity ターミナルエージェント |
| Claude Code | adhdev launch claude | 部分的 | Anthropic の Claude コーディングエージェント |
| Codex CLI | adhdev launch codex | 部分的 | OpenAI の Codex ターミナルエージェント |
| Cursor CLI | adhdev launch cursor-cli | 部分的 | Cursor のターミナルエージェントワークフロー |
| Hermes | adhdev launch hermes-cli | 未検証 | Hermes コーディングエージェント |
| Kimi | adhdev launch kimi | 未検証 | Moonshot の Kimi コーディングエージェント |
| OpenCode CLI | adhdev launch opencode | 未検証 | オープンソースのターミナルコーディングエージェント |
CLI が重要な理由
CLI エージェントは、しばしば作業を進め続ける最速の方法です。その理由:
- リポジトリとシェルのワークフローに近い状態を保つ
- リモートターミナル制御でうまく動作する
- IDE 固有の UI の破損を避ける
- ADHDev が再構成された抽象ではなく、正確なターミナルセッションをストリーミングできる
今日、最も信頼できるリモートワークフローが欲しいなら、CLI エージェントが通常最初に検証すべき経路です。現在公開されている格上げの中では、Claude Code、Codex CLI、Cursor CLI が最も明確な証拠を持っています。
CLI エージェントの起動
# Strong default paths
adhdev daemon
adhdev launch claude
adhdev launch codex
adhdev launch cursor-cli
# Additional built-in CLI providers
adhdev launch antigravity-cli
adhdev launch hermes-cli
adhdev launch kimi
adhdev launch opencode起動前に、マシンの Providers タブでプロバイダーが有効化されているか、構成された実行ファイルに対して Detect が成功するかを確認してください。バイナリがデフォルトの PATH の外にある場合は、まずカスタムの実行ファイルパス/引数を設定してください。
デーモンが PTY で CLI プロセスをスポーンし、出力をダッシュボードにストリーミングし、あなたの入力をプロセスに転送します。
通常の起動は新しいセッションとして扱われます。連続性が欲しい場合は、暗黙の自動再開に頼るのではなく、History やホスト型ランタイムの復旧のような明示的な再開経路を使ってください。
WARNING
各 CLI ツールは自身の認証を処理します。ADHDev は PTY セッションとリモート制御レイヤーを管理し、アップストリームツールのログインフローは管理しません。
ターミナルワークフロー
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 エージェントは、ダッシュボードの歯車ボタンから設定を構成できます:
| 設定 | 説明 |
|---|---|
| 通知 | 状態変化の通知を表示 |
| 自動承認 | サポートされている場合、ツール実行を自動承認 |
| 承認通知 | 承認が必要なときに通知 |
| 長時間生成アラート | ターンが長く実行されすぎたときに警告 |
| 長時間生成しきい値 | 秒単位のしきい値（30–600） |
CLI vs ACP
| 機能 | CLI エージェント（PTY） | ACP エージェント（stdio） |
|---|---|---|
| インターフェース | 完全なターミナルセッション | 構造化されたチャットプロトコル |
| レンダリング | xterm.js / 生ターミナル | Markdown / コンテンツブロック |
| 適した用途 | 実際のシェルワークフロー、TUI ツール、リモート監督 | 構造化されたイベントを持つプロトコルネイティブなエージェント |
| 検証モデル | デフォルトで未検証。プロバイダーごとに検証 | デフォルトで未検証。プロバイダーごとに検証 |
トラブルシューティング
エージェントが起動しない
- ツールがローカルにインストールされているか確認
- マシンの Providers タブでプロバイダーを有効化し、Detect を実行
- バイナリがデフォルトの PATH の外にある場合、カスタムの実行ファイルパス/引数を設定
- アップストリームの認証または API キーを確認
adhdev daemon:statusでローカルのヘルスを検査
ターミナルが空白
- ツールが入力を待っている可能性があります
- ダッシュボードで接続ステータスを確認
- 重複セッションを開始する前に、非表示タブ、インボックス、履歴を確認
- ランタイムが生き残っていた場合は、すぐに再起動する代わりに Hosted Runtimes を通じて復旧
ターミナル出力がおかしい
- アップストリームツールがターミナルを不正な状態のままにした場合は、セッションを再起動
- CLI プロバイダーの正規の出力としてターミナルビューを扱う
- 問題が続く場合は、プロバイダーの互換性の問題として扱い、まず互換性ページを確認