CLI コマンド

エンドユーザー向けの adhdev コマンドラインツールのリファレンス。

グローバルコマンド

`adhdev`

ヘルプと利用可能なコマンドを表示します。

`adhdev setup`

対話型のセットアップウィザード。マシンを ADHDev Cloud に認証します。

bash

adhdev setup
# デバイス認証のためにブラウザが開く
# トークンは ~/.adhdev/config.json に保存される

`adhdev daemon`

デーモンプロセスを起動します。IDE と ADHDev サーバーに接続します。

bash

adhdev daemon
# フォアグラウンドで実行、停止するには Ctrl+C

ローカル専用の standalone サーバーが欲しい場合は、代わりにセルフホストのドキュメントを参照してください:

`adhdev standalone`

セルフホストの standalone サーバーを起動します: ローカルダッシュボード + 組み込みデーモン + standalone の session-host 名前空間。

bash

adhdev standalone
adhdev standalone --host 0.0.0.0
adhdev standalone --port 8080
adhdev standalone --token mysecret
adhdev standalone --no-open
adhdev standalone --dev

クラウド接続のデーモンフローの代わりに、セルフホスト/ローカル専用の経路を明示的に使いたいときに使用してください。

重要な動作:

--host を渡さない限り、standalone はデフォルトで localhost 専用のままです
トークン認証やダッシュボードパスワードなしで 0.0.0.0 に公開すると、standalone はダッシュボードが LAN に開かれていると警告します
standalone はデフォルトで独自の session-host 名前空間を使用するため、同じマシンでクラウド接続のデーモンとホスト型ランタイムを奪い合いません

より詳しいセルフホストの詳細は、次を参照してください:

`adhdev daemon:status`

現在のデーモンのステータスとローカルのヘルス情報を表示します。

bash

adhdev daemon:status
adhdev daemon:status --port 19222

このコマンドは次を報告します:

デーモンの PID とログのパス
ローカル IPC の到達可能性
利用可能な場合は session-host のステータス
デーモン IPC が利用できないときの直接フォールバックのステータス

`adhdev status`

現在のマシンのセットアップステータスを表示します。

bash

adhdev status

デーモン/ランタイムの診断ではなく、「このマシンは構成されていてログインしているか？」への手早い答えが欲しいときに使ってください。

`adhdev mcp`

Claude Desktop のような MCP クライアントが ADHDev セッションを検査・制御できるように、stdio 経由で ADHDev MCP サーバーを起動します。

bash

# Local mode: localhost:3847 の standalone デーモンと通信
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password

# Mesh mode: デーモン IPC 経由のコーディネータースコープのツール
adhdev mcp --mode ipc --repo-mesh mesh_abc123

# Delegated-worker mode（デーモンが起動する最小限のツールセット）
adhdev mcp --mode ipc --worker

Claude Desktop スタイルの設定:

json

{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp"]
    }
  }
}

利用可能なツール（ローカル/Mesh モード）: list_daemons、list_sessions、launch_session、stop_session、check_pending、read_chat、read_chat_debug、send_chat、approve、git_status、git_log、git_diff、git_checkpoint、git_push、screenshot。Mesh モード（--repo-mesh）はこれに加えて、コーディネータースコープの mesh_* ツールセットを公開します。--worker モードは、委任ワーカーが必要とする最小限のツールセットのみを公開します。

オプション:

フラグ	説明
`--mode <mode>`	MCP トランスポートモード: `local` または `ipc`
`--repo-mesh <mesh_id>`	Mesh モードで起動（コーディネータースコープのツール）
`--worker`	Delegated-worker モード — 最小限のワーカーツールセットのみを公開
`--port <n>`	ローカルモードのための standalone デーモンポート（デフォルト: `3847`）
`--password <pass>`	構成されている場合の standalone デーモンのパスワード/トークン

起動コマンド

`adhdev launch [target]`

CDP を有効にして IDE を起動または再起動するか、実行中のデーモンを通じて CLI エージェントを開始します。

CLI プロバイダーの場合、通常の起動はデフォルトで新規セッションです。再開/復旧は、保存済みセッションを明示的に選ぶか、意図的にホスト型ランタイムの復旧を使うときにのみ行われるべきです。

bash

# IDEs
adhdev launch cursor          # Launch Cursor (CDP port 9333)
adhdev launch antigravity     # Launch Antigravity (CDP port 9335)
adhdev launch windsurf        # Launch Windsurf (CDP port 9336)
adhdev launch vscode          # Launch VS Code
adhdev launch kiro            # Launch Kiro

# CLI Agents (8 built-in)
adhdev daemon                 # Start the daemon once
adhdev launch claude          # Launch Claude Code session
adhdev launch codex-cli       # Launch Codex CLI session
adhdev launch cursor-cli      # Launch Cursor CLI session
adhdev launch opencode        # Launch OpenCode CLI session
adhdev launch antigravity-cli # Launch Antigravity CLI session
adhdev launch grok-cli        # Launch Grok CLI session
adhdev launch kimi            # Launch Kimi session

オプション:

フラグ	説明
`-w, --workspace <path>`	特定のワークスペース/フォルダーを開く
`-n, --new-window`	新しいウィンドウで開く
`-d, --dir <path>`	CLI エージェントの作業ディレクトリ（`-w` とは別。デフォルトはカレントディレクトリ）

WARNING

IDE に対する adhdev launch は、既存の IDE プロセスを閉じ、CDP を有効にして再度開きます。先に作業を保存してください。

履歴コマンド

`adhdev history list <provider>`

あるプロバイダーの、保存されたプロバイダーネイティブの CLI 履歴を一覧表示します。

bash

adhdev history list claude
adhdev history list codex-cli --json
adhdev history list codex-cli --limit 10 --offset 10
adhdev history list claude --resumable
adhdev history list claude --sort oldest
adhdev history list claude --sort messages
adhdev history list claude --text "reply with exactly" --workspace remote_vs --model gpt-5.4

実際の目標が次のようなときに、まず使ってください:

「どの会話を続けられるか？」
「欲しいコンテキストはどのプロバイダー履歴にあるか？」
「再開可能なワークスペースを持つ保存済みセッションはどれか？」

このコマンドは、session-host のランタイムレコードではなく、保存された履歴のメタデータ（providerSessionId、ワークスペース、プレビュー、メッセージ数）を読みます。

便利なフィルターとソートモード:

--resumable → --dir なしですぐに再開できるエントリのみを表示
--text <text> → タイトルまたはプレビューの部分文字列でフィルタリング
--workspace <text> → ワークスペースパスの部分文字列でフィルタリング
--model <text> → モデルの部分文字列でフィルタリング
--sort recent → 最新のアクティビティ順（デフォルト）
--sort oldest → 古いアクティビティ順
--sort messages → メッセージ数の多い順

`adhdev history resume <provider> [historySessionId]`

プロバイダーネイティブの保存済み履歴セッションを再開します。

bash

adhdev history resume claude 20260414_101931_38d017
adhdev history resume codex-cli 20260413_163128_d61494
adhdev history resume claude --dir /path/to/worktree   # choose interactively when omitted
adhdev history resume claude --resumable --sort messages
adhdev history resume claude --text "sonnet follow-up" --workspace remote_vs --model gpt-5.4

これは、通常の CLI 利用における主要な連続性の経路です。同じプロバイダーの会話で話し続けたい場合は、ランタイムの attach/recover よりもこちらを優先してください。 historySessionId を省略すると、ADHDev は次のようにします:

再開可能な保存済み履歴エントリが 1 つだけなら自動選択する、または
再開可能なエントリが複数存在する場合は対話型のピッカーを開く。

対話型ピッカーの制御:

--resumable → まだ --dir が必要なエントリを隠す
--text <text> → タイトルまたはプレビューの部分文字列でフィルタリング
--workspace <text> → ワークスペースパスの部分文字列でフィルタリング
--model <text> → モデルの部分文字列でフィルタリング
--sort recent|oldest|messages → history list と同じ並び替えのセマンティクスを使う

保存されたエントリにワークスペースのメタデータがない場合は、--dir を明示的に渡してください。

ランタイムコマンド

`adhdev runtime list`

生の session-host 診断の代わりに、live/recovery/inactive のグループを使って、ホスト型ランタイムの復旧および診断の状態を一覧表示します。

bash

adhdev runtime list
adhdev runtime list --all
adhdev runtime list --json

デフォルトでは、レコードを次にグループ化します:

ライブランタイム
復旧スナップショット
--all が要求されたときの非アクティブレコード

次に答えたいときに、まず使ってください:

「今、実際にライブなのは何か？」
「復旧できるのは何か？」
「どのレコードが単なる古いスナップショットか？」

`adhdev runtime attach <runtimeTarget>`

現在のターミナルをライブのホスト型ランタイムに直接接続します。

bash

adhdev runtime attach <runtimeTarget>
adhdev runtime attach <runtimeTarget> --read-only
adhdev runtime attach <runtimeTarget> --takeover

このコマンドはライブランタイムのみを受け付けます。ターゲットが復旧スナップショットや非アクティブな停止レコードの場合、ターゲットが接続可能なふりをする代わりに、すばやく失敗し、代わりに復旧または再起動するように伝えます。

`adhdev runtime open <runtimeTarget>`

ライブのホスト型ランタイムのための adhmux ワークスペースを開きます。

bash

adhdev runtime open <runtimeTarget>
adhdev runtime open <runtimeTarget> --read-only
adhdev runtime open <runtimeTarget> --workspace review-pane
adhdev runtime open <runtimeTarget> -n review-pane   # --workspace の短縮エイリアス

高度な mux/ペインのワークフローを明示的に使いたいときに使用してください。通常のターミナルの attach および復旧のフローは、依然として adhdev runtime attach、adhdev runtime recover、または adhdev runtime restart から始めるべきです。

`adhdev runtime recover <runtimeTarget>`

ホスト型ランタイムのレコードを復旧または再開します。

bash

adhdev runtime recover <runtimeTarget>
# alias
adhdev runtime resume <runtimeTarget>

`adhdev runtime restart <runtimeTarget>`

ホスト型ランタイムのレコードを再起動します。

bash

adhdev runtime restart <runtimeTarget>

`adhdev runtime stop <runtimeTarget>`

ホスト型ランタイムのレコードを停止します。

bash

adhdev runtime stop <runtimeTarget>

`adhdev runtime snapshot <runtimeTarget>`

ホスト型ランタイムのレコードの最新のターミナルスナップショットを出力します。

bash

adhdev runtime snapshot <runtimeTarget>
adhdev runtime snapshot <runtimeTarget> --json

<runtimeTarget> は、セッション ID、ランタイムキー、表示名、または adhdev runtime list からの一意のプレフィックスにできます。

これは、ホスト型ランタイムの復旧および診断のサーフェスです。プロバイダーの会話履歴を続ける通常の方法としてではなく、中断の後にランタイムプロセス自体を復旧する必要があるときに使ってください。

最も一般的な 2 つのランタイムアクションには、トップレベルのショートカットもあります:

bash

adhdev attach <runtimeTarget>
adhdev recover <runtimeTarget>
adhdev resume <runtimeTarget>

これらは adhdev runtime attach と adhdev runtime recover の直接のショートカットです。

Session Host コマンド

`adhdev daemon:session-host`

ローカルの session host を検査・制御します。

これは adhdev runtime ... の背後にある、高度な診断とオペレーター制御のサーフェスです。ほとんどのユーザーはまずランタイムサーフェスから始めるべきなので、主要な CLI ヘルプからは意図的に目立たなくされています。

bash

# 診断スナップショットを表示
adhdev daemon:session-host

# デフォルト以外のデーモン IPC ポートを使用
adhdev daemon:session-host --port 19222

# 生の診断 JSON を出力
adhdev daemon:session-host --json

# ホスト型ランタイムを再起動
adhdev daemon:session-host --session <sessionId> --restart

# ランタイムを再開
adhdev daemon:session-host --session <sessionId> --resume

# ランタイムを停止
adhdev daemon:session-host --session <sessionId> --stop

# シグナルを送信
adhdev daemon:session-host --session <sessionId> --signal SIGINT

# 詰まったクライアントを強制的に切り離す
adhdev daemon:session-host --session <sessionId> --detach-client <clientId>

# 同じプロバイダーセッションの古い重複ランタイムを整理
adhdev daemon:session-host --prune-duplicates

# 書き込み所有権を強制取得
adhdev daemon:session-host --session <sessionId> --acquire-write <clientId> --owner-type user

# 書き込み所有権を解放
adhdev daemon:session-host --session <sessionId> --release-write <clientId>

ホスト型 CLI セッションが詰まったり、切断されたり、手動での復旧が必要なときに使ってください。

ホスト型ランタイムの復旧は意図的に明示的です。通常のデーモン起動は、あなた自身がその挙動をオプトインしない限り、ホスト型 CLI セッションを自動的に再度開くことはありません。

オプション:

フラグ	説明
`-p, --port <port>`	ローカルデーモンの IPC ポート
`--json`	JSON 出力
`--limit <count>`	含める最近の診断エントリの数
`--session <sessionId>`	対象のランタイムセッション
`--restart`	対象のランタイムを再起動
`--resume`	対象のランタイムを再開
`--stop`	対象のランタイムを停止
`--signal <signal>`	`SIGINT` や `SIGTERM` などのシグナルを送信
`--detach-client <clientId>`	特定の接続済みクライアントを強制的に切り離す
`--prune-duplicates`	古い重複ホスト型ランタイムを削除
`--acquire-write <clientId>`	クライアントの書き込み所有権を強制取得
`--release-write <clientId>`	クライアントの書き込み所有権を解放
`--owner-type <type>`	`--acquire-write` の所有者タイプ: `user` または `agent`

session-host とデーモンの状態が同期していないように見えるとき、ランタイムが interrupted 状態で詰まっているとき、または書き込み所有権を手動で復旧する必要があるときに使ってください。

サービス管理

`adhdev service install`

ADHDev デーモンを、ログイン時に自動的に起動する OS のバックグラウンドサービスとして登録します。

bash

adhdev service install

プラットフォーム	方法
macOS	LaunchAgent plist (`~/Library/LaunchAgents/dev.adhf.daemon.plist`)
Windows	スタートアップフォルダー内の VBScript（非表示のコンソールウィンドウ）
Linux	組み込みの自動インストールヘルパーなし

デーモンはクラッシュすると自動的に再起動しますが、きれいに終了した場合（例: 別のインスタンスがすでに実行中のとき）は再起動ループ しません。

`adhdev service uninstall`

OS のバックグラウンドサービスを削除します。現在実行中のデーモンには影響しません — adhdev daemon:stop で別途停止してください。

bash

adhdev service uninstall

`adhdev service status`

サービスの登録状態と、ライブのデーモンのヘルス（PID、稼働時間、メモリ、ログサイズ）を表示します。

bash

adhdev service status
# ✓ Service is installed.
# ✓ Daemon running — PID 12723, uptime 2h 13m, 58 MB
# Logs: stdout 4.2 KB, stderr 0 B

`adhdev service logs`

デーモンのサービスログをリアルタイムで見ます（tail -f）。

bash

adhdev service logs             # Follow stdout log
adhdev service logs --err       # Follow stderr log
adhdev service logs -n 50       # Show last 50 lines
adhdev service logs --clear     # Truncate all log files

`adhdev service restart`

OS のサービスを通じてデーモンを再起動します。現在のプロセスに SIGTERM を送り、サービスマネージャー（launchd / Windows のスタートアップ）に再起動させます。10 MB を超えるログもローテーションします。

bash

adhdev service restart

アカウントとデータ

`adhdev logout`

ADHDev からログアウトします。認証情報をクリアしますが、IDE とワークスペースの設定は保持します。

bash

adhdev logout
adhdev logout -f   # Skip confirmation prompt

`adhdev reset`

ADHDev の構成をリセットします。~/.adhdev/config.json をクリアする前に確認を求めます。

bash

adhdev reset

`adhdev uninstall`

システムから ADHDev を完全に削除します。デーモンを停止し、OS のバックグラウンドサービスを削除し、~/.adhdev 内のすべてのデータを削除します。

bash

adhdev uninstall
adhdev uninstall -f   # Skip confirmation prompt
adhdev uninstall --dry-run   # 削除内容だけを表示し、実際には削除しない

このコマンドは次のステップを実行します:

実行中のデーモンプロセスを停止します（存在する場合）
OS のバックグラウンドサービス（LaunchAgent / Startup スクリプト）を削除します
~/.adhdev/ を削除します — すべての構成、認証トークン、ログ、キャッシュされたデータ
npm uninstall -g adhdev で仕上げるための指示を出力します

WARNING

これは元に戻せません。すべての設定、認証情報、ダウンロードされたプロバイダーが永久に削除されます。認証や構成のみをクリアしたい場合は、adhdev logout または adhdev reset を使ってください。

バージョンとアップグレード

`adhdev --version`

現在の ADHDev のバージョンを表示します。

`adhdev update`

ADHDev を最新バージョンにアップグレードし、デーモンを再起動します。adhdev daemon:upgrade のエイリアス。

bash

adhdev update
adhdev update --no-restart   # Upgrade only, skip daemon restart

adhdev update と adhdev daemon:upgrade はどちらも、古い呼び出しとの後方互換性のために --channel <channel> フラグも受け付けます — リリースチャンネルはビルド時に固定されるため、このフラグは非推奨であり黙って無視されます。

`adhdev daemon:upgrade`

デーモンを最新バージョンにアップグレードします。

bash

adhdev daemon:upgrade
# Downloads and installs latest version

`adhdev daemon:api [mode]`

サーバーの REST API リレーアクセスを管理します。デフォルトでは無効 — ダッシュボードのトラフィックは常に P2P/ローカル IPC を使用します。

bash

adhdev daemon:api           # Show current status
adhdev daemon:api enable    # Allow server-side REST proxy routes
adhdev daemon:api disable   # Revoke server-side REST proxy routes

これはサーバーの API プロキシルートにのみ影響します。ダッシュボードのコマンド/データプレーンは、この設定に関係なく P2P ファーストのままです。

クォータコマンド

`adhdev quota <provider>`

AI コーディングエージェントの残りプランクォータを表示します。antigravity/agy、codex、grok、kimi はプロバイダー自身の使用状況 API をライブでクエリします — インストールは不要です。

bash

adhdev quota antigravity   # alias: agy
adhdev quota codex
adhdev quota grok
adhdev quota kimi
adhdev quota claude         # requires `adhdev quota claude:install` first

Claude Code は statusLine フックを通じてのみ使用状況の数値を公開しているため、それを読み取るにはそのスロットをラッパーで占有する必要があります。これはオプトインであり、自動的には決して行われません:

bash

adhdev quota claude:install     # alias: claude-install — wraps your existing statusline
adhdev quota claude:uninstall   # alias: claude-uninstall — restores your original statusline
adhdev quota claude:status      # show whether the wrapper is set up

codex と kimi には install/uninstall/status サブコマンドがありません — ライブ API クエリのためにセットアップするものが何もないためです。

`adhdev quota refresh [providers...]`

実行中のデーモンに、今すぐプロバイダーのクォータを再読み込みするよう要求します。これにより、デーモン自身のキャッシュが期限切れになるのを待つことなく、ダッシュボードと Mesh のルーティングが更新された数値をすぐに参照できます。

bash

adhdev quota refresh              # refresh all providers
adhdev quota refresh codex kimi   # refresh specific providers

現在自身の HTTP 429 クールダウン中のプロバイダーは再プローブされません（再度ヒットするとスロットルが延長されてしまうため）。代わりに、クールダウンが解除される時刻とともに報告されます。claude と codex はクールダウンのないローカルファイルプロバイダーであり、常に再読み込みされます。

設定コマンド

`adhdev config env set/unset/list`

再起動やアップグレードをまたいで残る、デーモンスコープの env/機能フラグのオーバーライドを永続化します。次回のデーモン再起動時に適用されます（現在実行中のプロセスには適用されません）。

bash

adhdev config env set ADHDEV_WORKER_MCP on
adhdev config env unset ADHDEV_WORKER_MCP
adhdev config env list

このサーフェスは機能フラグ専用です — シークレット、トークン、認証情報のように見えるキーは拒否されます。明示的な process.env の値は、常に永続化されたオーバーライドより優先されます。

診断

`adhdev doctor`

インストールの健全性、ネイティブ依存関係、CLI の解決、フォルダー参照アクセスを診断します。

bash

adhdev doctor

これは（とりわけ）ビルドトラック、ネイティブモジュールの読み込み（例: node-datachannel、sharp）、インストールがリンク済み/開発版か通常の npm グローバルパッケージか、PATH 上の CLI バイナリの解決、一般的なフォルダー参照ルートへの読み取りアクセスをチェックします。デーモンやそのネイティブ依存関係で何かが壊れているように見えるときは、問題を報告する前にまずこれを使ってください。

高度なコマンド

adhdev provider ...、adhdev cdp ...、adhdev daemon --dev などのコマンドは、主に診断、プロバイダー作業、またはローカルのデバッグ用です。ここでは、通常のユーザーワークフローから意図的に除外しています。

CLI コマンド ​

グローバルコマンド ​

adhdev ​

adhdev setup ​

adhdev daemon ​

adhdev standalone ​

adhdev daemon:status ​

adhdev status ​

adhdev mcp ​

起動コマンド ​

adhdev launch [target] ​

履歴コマンド ​

adhdev history list <provider> ​

adhdev history resume <provider> [historySessionId] ​

ランタイムコマンド ​

adhdev runtime list ​

adhdev runtime attach <runtimeTarget> ​

adhdev runtime open <runtimeTarget> ​

adhdev runtime recover <runtimeTarget> ​

adhdev runtime restart <runtimeTarget> ​

adhdev runtime stop <runtimeTarget> ​

adhdev runtime snapshot <runtimeTarget> ​

Session Host コマンド ​

adhdev daemon:session-host ​

サービス管理 ​

adhdev service install ​

adhdev service uninstall ​

adhdev service status ​

adhdev service logs ​

adhdev service restart ​

アカウントとデータ ​

adhdev logout ​

adhdev reset ​

adhdev uninstall ​

バージョンとアップグレード ​

adhdev --version ​

adhdev update ​

adhdev daemon:upgrade ​

adhdev daemon:api [mode] ​

クォータコマンド ​

adhdev quota <provider> ​

adhdev quota refresh [providers...] ​

設定コマンド ​

adhdev config env set/unset/list ​

診断 ​

adhdev doctor ​

高度なコマンド ​

CLI コマンド

グローバルコマンド

`adhdev`

`adhdev setup`

`adhdev daemon`

`adhdev standalone`

`adhdev daemon:status`

`adhdev status`

`adhdev mcp`

起動コマンド

`adhdev launch [target]`

履歴コマンド

`adhdev history list <provider>`

`adhdev history resume <provider> [historySessionId]`

ランタイムコマンド

`adhdev runtime list`

`adhdev runtime attach <runtimeTarget>`

`adhdev runtime open <runtimeTarget>`

`adhdev runtime recover <runtimeTarget>`

`adhdev runtime restart <runtimeTarget>`

`adhdev runtime stop <runtimeTarget>`

`adhdev runtime snapshot <runtimeTarget>`

Session Host コマンド

`adhdev daemon:session-host`

サービス管理

`adhdev service install`

`adhdev service uninstall`

`adhdev service status`

`adhdev service logs`

`adhdev service restart`

アカウントとデータ

`adhdev logout`

`adhdev reset`

`adhdev uninstall`

バージョンとアップグレード

`adhdev --version`

`adhdev update`

`adhdev daemon:upgrade`

`adhdev daemon:api [mode]`

クォータコマンド

`adhdev quota <provider>`

`adhdev quota refresh [providers...]`

設定コマンド

`adhdev config env set/unset/list`

診断

`adhdev doctor`

高度なコマンド