スタートガイド
このガイドは、最初のインストールから ADHDev を通じて最初の AI エージェントとチャットするまでを案内します。約 5 分かかります。
ADHDev は 2 つのモードで実行されます。インストールコマンドは同じですが、ダッシュボードの URL とアカウントのフローが異なります。
| Cloud | Standalone | |
|---|---|---|
| アカウント | GitHub または Google | なし |
| ダッシュボード | https://adhf.dev | http://localhost:3847 |
| 適した用途 | ネットワークをまたぐマシン、リモートアクセス、共有 | ローカル利用、プライバシー、同一ネットワークのマシンのペアリング |
以下のデフォルトの経路は Cloud です — インストールスクリプトが自動的にセットアップしてくれます。アカウントなしで完全にローカルのまま使いたい場合は、ステップ 1・ステップ 2 内の Standalone の項目を見てください — これは代替手段ではなく、正式にサポートされた経路です。
ステップ 1 — CLI のインストール
インストールスクリプトを実行します。プラットフォームを検出し、必要なら Node.js をインストールし、adhdev CLI を PATH に追加し、Cloud の場合はそのままサインインまで案内します。
macOS / Linux:
curl -fsSL https://adhf.dev/install | shWindows (PowerShell):
irm https://adhf.dev/install.ps1 | iexmacOS / Linux（Homebrew）:
brew tap vilmire/adhdev
brew install adhdevHomebrew は独自の Node.js ランタイムを同梱するため、adhdev をグローバルな npm 環境から切り離した状態に保てます。（上記のインストールスクリプトも、macOS で Homebrew が利用可能な場合は自動的にそれを使用します。）
npm 経由（任意のプラットフォーム）:
npm install -g adhdevWARNING
Windows では、Node.js 24+ でのグローバル npm インストールは現在サポートされていません。PowerShell インストーラーがポータブルな Node.js 22 ランタイムを自動的にブートストラップします。
期待される結果:
adhdev --versionバージョン番号が出力されます。command not found と表示される場合は、新しいターミナルウィンドウを開いてください — インストーラーが PATH を User スコープに永続登録するため、再起動後も有効です。再起動後も解決しない場合は Windows PATH トラブルシューティング を参照してください。
Cloud
上記のインストールスクリプトは、インストール直後にセットアップウィザード（adhdev setup）をすでに実行しています — adhf.dev に対するデバイス認証のためにブラウザタブを開き、GitHub または Google でサインインさせ、このマシンを登録し、デーモンを起動します。それが完了していれば、そのままステップ 3 に進んでください。
ウィザードが自動実行されなかった場合（ADHDEV_NO_SETUP=1、非対話シェル、または command not found を直した後の仕上げ作業の場合）のみ、自分で実行してください:
adhdev setupTIP
Cloud のサインインには、OAuth プロバイダーからの検証済みメールアドレスが必要です。GitHub/Google アカウントに検証済みのメールがない場合、どのアカウントを紐付けるか推測する代わりにサインインが拒否されます。
期待される結果: ウィザードが Setup complete を出力し、マシンを登録し、デーモンを起動するかどうか尋ねます（デフォルト: はい）。
Standalone
Standalone はアカウントが不要なため、セットアップウィザードをまったく使いません。そのまま下のステップ 2 に進み、adhdev standalone を直接実行してください。
ステップ 2 — ダッシュボードを開く
Cloud
セットアップの時点ですでにデーモンが起動していれば、今も実行中です — ブラウザで https://adhf.dev を開き、必要ならサインインしてから、下の期待される結果に進んでください。
そうでない場合は、自分で起動します:
adhdev daemonデーモンが api.adhf.dev に接続し、このマシンを登録し、マシン ID を出力します。
期待される結果: ダッシュボードのマシンリストに、数秒以内に緑色のインジケーターとともにマシンが online と表示されます。WebRTC チャネルが確立されると「P2P connected」が表示されます。
マシンが表示されない場合:
adhdev doctorこのコマンドは、デーモンプロセス、WebSocket 接続、ローカルプロバイダーレジストリを確認します。ほとんどの問題は、具体的な修正方法とともにフラグが立てられます。
Standalone
adhdev standaloneこのコマンドは、デーモンとダッシュボードを1つのローカルサーバーとして http://localhost:3847 で一緒に起動し、ブラウザで自動的に開きます。
期待される結果: ローカルマシンが「online」の状態で表示された、空のマシンリストを持つダッシュボードが読み込まれます。ログイン画面はありません。
ネットワーク上の別のデバイスから LAN アクセスしたい場合:
adhdev standalone --host 0.0.0.0 --token <some-secret>ステップ 3 — プロバイダーを選ぶ
プロバイダー は、ADHDev の 1 つの AI エージェントに対するアダプターです。初回利用で重要な 2 つのカテゴリ:
- CLI プロバイダー — Claude Code、Codex CLI、Antigravity CLI などのターミナルベースのエージェント。デーモンが PTY のもとで実行し、ターミナルをダッシュボードにパイプします。
- IDE プロバイダー — Cursor、VS Code、Antigravity、Windsurf などの実行中のエディター。デーモンが Chrome DevTools Protocol（CDP）を通じて接続し、IDE 内部のエージェントパネルを読み書きします。
ADHDev がマシンで検出したものを見るには:
adhdev detect期待される結果: 既知の各プロバイダーについて installed: yes/no が付いたリスト。yes と表示されたものはすぐに起動できます。
推奨される出発点
最もスムーズな初回実行のために、すでにインストール済みのもののいずれかを選んでください:
- Claude Code（CLI）—
adhdev launch claude - Codex CLI —
adhdev launch codex-cli - 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 エージェントの場合、モデルが生成するにつれてチャットバブルが更新されます。
- エージェントが発生させるツール/承認プロンプトは、同じ承認/拒否ボタンとともにダッシュボードにミラーリングされます。
プロンプトは届いたのに応答がない場合は、次を確認してください:
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 ではアカウント連携、Standalone では同一ネットワークでペアリング）
- 互換性と注意事項 — 検証済みのもの vs. 実験的なもの
- トラブルシューティング — よくある失敗とその修正
さらに深く
- Provider Guide — カスタムプロバイダーを書く
- Provider SDK — マニフェスト、TUI プリミティブ、デバッグ
アンインストール
adhdev uninstall # stops the daemon, removes ~/.adhdev/
npm uninstall -g adhdev # also removes the CLI itselfローカルの状態を失わずにアカウントを切り替えるには、代わりに adhdev logout を使用してください。