スタートガイド

このガイドは、最初のインストールから ADHDev を通じて最初の AI エージェントとチャットするまでを案内します。約 5 分かかります。

ADHDev は 2 つのモードで実行されます。始める前にどちらか一方を選んでください — インストールコマンドは同じですが、ダッシュボードの URL とアカウントのフローが異なります。

	Standalone	Cloud
アカウント	なし	GitHub または Google
ダッシュボード	`http://localhost:3000`	`https://adhf.dev`
適した用途	単一マシン、ローカル利用、プライバシー	マルチマシン、リモートアクセス、共有

迷ったら Standalone から始めてください。アンインストールせずに後から切り替えられます。

ステップ 1 — CLI のインストール

インストールスクリプトを実行します。プラットフォームを検出し、必要なら Node.js をインストールし、adhdev CLI を PATH に追加します。

macOS / Linux:

bash

curl -fsSL https://adhf.dev/install | sh

Windows (PowerShell):

powershell

irm https://adhf.dev/install.ps1 | iex

npm 経由（任意のプラットフォーム）:

bash

npm install -g adhdev

WARNING

Windows では、Node.js 24+ でのグローバル npm インストールは現在サポートされていません。PowerShell インストーラーがポータブルな Node.js 22 ランタイムを自動的にブートストラップします。

期待される結果:

bash

adhdev --version

バージョン番号が出力されます。command not found と表示される場合は、新しいターミナルウィンドウを開いてください — インストーラーが PATH を User スコープに永続登録するため、再起動後も有効です。再起動後も解決しない場合は Windows PATH トラブルシューティングを参照してください。

次に、初回実行ウィザードを実行します。

bash

adhdev setup

Standalone の場合は、ローカル専用オプションを選択してください — ブラウザでのサインインは不要です。 Cloud の場合は、ウィザードが adhf.dev に対するデバイス認証のためにブラウザタブを開きます。GitHub または Google でサインインしてください。

TIP

Cloud のサインインには、OAuth プロバイダーからの検証済みメールアドレスが必要です。GitHub/Google アカウントに検証済みのメールがない場合、どのアカウントを紐付けるか推測する代わりにサインインが拒否されます。

期待される結果: ウィザードが Setup complete を出力し、デーモンを起動するコマンドを教えてくれます。

ステップ 2 — ダッシュボードを開く

Standalone

bash

adhdev standalone

standalone コマンドは、デーモン（localhost:3847）とダッシュボード（localhost:3000）を同時に起動します。

ブラウザで http://localhost:3000 を開いてください。

期待される結果: ローカルマシンが「online」の状態で表示された、空のマシンリストを持つダッシュボードが読み込まれます。ログイン画面はありません。

ネットワーク上の別のデバイスから LAN アクセスしたい場合:

bash

adhdev standalone --host 0.0.0.0 --token <some-secret>

Cloud

bash

adhdev daemon

デーモンが api.adhf.dev に接続し、このマシンを登録し、マシン ID を出力します。

ブラウザで https://adhf.dev を開いてください。プロンプトが表示されたらサインインします。

期待される結果: ダッシュボードのマシンリストに、数秒以内に緑色のインジケーターとともにマシンが online と表示されます。WebRTC チャネルが確立されると「P2P connected」が表示されます。

マシンが表示されない場合:

bash

adhdev doctor

このコマンドは、デーモンプロセス、WebSocket 接続、ローカルプロバイダーレジストリを確認します。ほとんどの問題は、具体的な修正方法とともにフラグが立てられます。

ステップ 3 — プロバイダーを選ぶ

プロバイダー は、ADHDev の 1 つの AI エージェントに対するアダプターです。初回利用で重要な 2 つのカテゴリ:

CLI プロバイダー — Claude Code、Codex CLI、Antigravity CLI、Hermes CLI などのターミナルベースのエージェント。デーモンが PTY のもとで実行し、ターミナルをダッシュボードにパイプします。
IDE プロバイダー — Cursor、VS Code、Antigravity、Windsurf などの実行中のエディター。デーモンが Chrome DevTools Protocol（CDP）を通じて接続し、IDE 内部のエージェントパネルを読み書きします。

ADHDev がマシンで検出したものを見るには:

bash

adhdev detect

期待される結果: 既知の各プロバイダーについて installed: yes/no が付いたリスト。yes と表示されたものはすぐに起動できます。

推奨される出発点

最もスムーズな初回実行のために、すでにインストール済みのもののいずれかを選んでください:

Claude Code（CLI）— adhdev launch claude
Codex CLI — adhdev launch codex
Cursor（IDE）— adhdev launch cursor

adhdev launch はデーモンのもとでエージェントを開きます。IDE の場合は CDP を有効にした状態でエディターを再起動します。

WARNING

adhdev launch <ide> は、CDP を有効にした状態で起動できるように IDE を閉じて再度開きます。先に作業を保存してください。

期待される結果: ダッシュボードにエージェント用の新しいカード（またはマシンビュー内の新しいタブ）が現れ、ターミナル出力または IDE の状態がリアルタイムで表示されます。

ステップ 4 — 最初のプロンプトを送る

ダッシュボードで、たった今起動したエージェントのカードをクリックすると、2 つのビューのいずれかが表示されます:

CLI ビュー — 下部に入力ボックスがあるライブターミナル。ローカルターミナルで行うのと同じように、プロンプトを入力して Enter（または Send をクリック）を押してください。
IDE ビュー — エディター内部のエージェントパネルをミラーリングするチャットパネル。プロンプトを入力して Send をクリックしてください。

簡単なものを試してみましょう:

現在のディレクトリのファイル一覧を表示して、これがどんな種類のプロジェクトなのか教えて。

期待される結果:

プロバイダーがエージェントの応答をリアルタイムでダッシュボードにストリーミングします。
CLI エージェントの場合、ローカルターミナルで見られるのと同じトークンが表示されます。
IDE エージェントの場合、モデルが生成するにつれてチャットバブルが更新されます。
エージェントが発生させるツール/承認プロンプトは、同じ承認/拒否ボタンとともにダッシュボードにミラーリングされます。

プロンプトは届いたのに応答がない場合は、次を確認してください:

bash

adhdev status         # daemon healthy?
adhdev provider list  # provider loaded?
adhdev doctor         # any auth or network issue?

エージェント自体が API キーやログイン（Anthropic、OpenAI、Google など）を要求する場合は、エージェント自身の UI または ~/.config で処理してください。ADHDev はそれらの認証情報を保存もプロキシもしません — 各ツールが自身の認証を保持します。

準備完了

これで、デーモンが実行され、ダッシュボードが接続され、少なくとも 1 つのエージェントが ADHDev のトランスポートを通じて応答するようになりました。

次に見るべきもの

ダッシュボードガイド — パネル、マシンスイッチャー、セッション共有
CLI エージェント — PTY セッション管理、スクロールバック、再起動
リモートビュー — 別のデバイスから IDE を制御（Cloud のみ）
マルチマシン — ノート PC + デスクトップ + 業務用マシンの連携（Cloud のみ）
互換性と注意事項 — 検証済みのもの vs. 実験的なもの
トラブルシューティング — よくある失敗とその修正

さらに深く

Provider Guide — カスタムプロバイダーを書く
Provider SDK — マニフェスト、TUI プリミティブ、デバッグ
Architecture — デーモン、ダッシュボード、P2P、サーバー（インフラおよびタイミング値の正式な情報源）

アンインストール

bash

adhdev uninstall     # stops the daemon, removes ~/.adhdev/
npm uninstall -g adhdev   # also removes the CLI itself

ローカルの状態を失わずにアカウントを切り替えるには、代わりに adhdev logout を使用してください。

スタートガイド ​

ステップ 1 — CLI のインストール ​

ステップ 2 — ダッシュボードを開く ​

Standalone ​

Cloud ​

ステップ 3 — プロバイダーを選ぶ ​

推奨される出発点 ​

ステップ 4 — 最初のプロンプトを送る ​

準備完了 ​

次に見るべきもの ​

さらに深く ​

アンインストール ​

スタートガイド

ステップ 1 — CLI のインストール

ステップ 2 — ダッシュボードを開く

Standalone

Cloud

ステップ 3 — プロバイダーを選ぶ

推奨される出発点

ステップ 4 — 最初のプロンプトを送る

準備完了

次に見るべきもの

さらに深く

アンインストール