互換性と注意事項
ADHDev は幅広い組み込みプロバイダーインベントリを提供していますが、互換性は依然として保守的に読むべきです。このページは、特定のワークフローに依存する前に期待値を設定する最速の方法です。
インベントリが第一、検証が第二
次の経験則に従ってください:
- 組み込みとは、プロバイダーが出荷されたインベントリに存在することを意味します。
- 検証済みとは、プロバイダーが手動でテストされ、格上げされたことを意味します。
- プロバイダーが格上げされるまでは、ランチャー、ドキュメント、または機能ページに表示されていても未検証として扱ってください。
再検証中
検証ステータスは現在全面的な再検証中です（オーナー決定、2026-08-03）。新しい検証結果が出るまで、すべてのプロバイダーは Unverified です — 出発点を選ぶ前に 対応プロバイダー で現在の状態を確認してください。
実用的な出発点
プロバイダーの選択は、現在 Partial の格上げではなく、ワークフローに合ったカテゴリを基準にすべきです — 現在アクティブな格上げはありません。カテゴリごとの全インベントリは 対応プロバイダー を参照してください。
IDE ワークフロー
ネイティブ IDE 制御、Remote View、セッション切り替えは ide カテゴリを通じて行われます。全リストは 対応 IDE を参照してください。
拡張機能ワークフロー
IDE 拡張機能（Cline、Roo Code、Codex、Claude Code for VS Code）は extension カテゴリを通じて行われます。プロバイダーが格上げされるまでは、すべて探索的なものとして扱ってください。
CLI ワークフロー
CLI エージェント（Claude Code、Codex CLI など）はホスト型の PTY/session-host スタックを通じて実行され、通常はリモートモニタリングと復旧フローを検証するのに最も簡単な場所です。
既知の注意事項
IDE サポートは Electron ファースト
ADHDev は IDE 制御のために Chrome DevTools Protocol に依存しています。つまり、Electron ベースの IDE が今日の主なターゲットです。
- 今日の Electron ファーストのターゲットセット: Cursor、Windsurf、Kiro、PearAI、Antigravity、Trae
- 検出/起動のカバレッジ: VS Code、VSCodium
- 今日は適さない: Zed、IntelliJ、および類似のネイティブデスクトップアプリなどの非 Electron IDE
VS Code ファミリーは Cursor/Windsurf と同じではない
VS Code と VSCodium は検出および起動できますが、ネイティブに統合された AI IDE と同じものではありません。Cline、Roo Code、Codex、または Claude Code のような拡張機能フローを追加すると、はるかに関連性が高くなります。
Trae には実際の注意事項がある
Trae はチャットと制御では動作しますが、そのモデルおよびモードのコントロールは依然として汎用的な UI 操作に依存しており、アプリのバージョンやレイアウトによっては失敗することがあります。
実際には:
- チャットの読み取りは動作する
- メッセージの送信は動作する
- Remote View は動作する
- モデル切り替えとモード切り替えは部分的として扱うべき
ACP の起動フラグはアップストリームに追従する
各 ACP アダプターは、対象ツールが必要とするフラグで起動します。これらのフラグは、エージェントが実験的から安定版へ移行するにつれてアップストリームに追従します。
- Qwen Code（ACP）は
--acpで起動します
アップストリームのツールがフラグを改名・削除した場合は、アダプターの起動引数を合わせて更新してください。
認証は依然としてツール固有
ADHDev は各ツール自身のログインフローを置き換えません。
- CLI および ACP エージェントは、依然として自身の API キーやログイン状態を必要とします
- 基盤となるツールをまだ認証していない場合、API キーの欠如は起動失敗のように見えることがあります
- これは Claude、Codex、および多くの ACP エージェントで特に重要です
プッシュ通知はプラットフォームに依存する
プッシュ通知は、ダッシュボードが PWA としてインストールされているときに最もよく機能します。
- iOS では Web プッシュのために PWA インストール経路が必要です
- 通知のアクションボタンは、すべてのプラットフォームで一貫して表示されるわけではありません
- アクションボタンが利用できない場合でも、通知自体は届くことがあります
Windows は現在 Node.js 24+ をブロックする
ADHDev は現在、通常の npm/グローバル CLI のインストールおよび起動について、Windows + Node.js 24+ をサポート対象外として扱います。
- PowerShell のワンライナーインストーラーは、この組み合わせを検出すると、ポータブルな Node.js 22 ランタイムをブートストラップするようになりました
- Windows で直接
npm install -g adhdevを使う予定なら、Node.js 22.x を使ってください - これは、Windows の PTY/session-host 経路が新しい Node リリースで安定するまでの一時的な保護措置です
Linux は依然としてインベントリファースト
一部のドキュメントやインベントリの表で Linux が言及されるのは、出荷されるプロバイダー/検出器のインベントリに、Linux 向けのプロセス名、ポート、Unix スタイルのコマンドパスが含まれているためです。
これをまだ公開のサポート約束として読むべきではありません。
- 現在の公開のインストールテスト済み経路は macOS と Windows です
- Linux はまだ、サポートされた経路として提示できるほど検証されていません
- 今日 Linux で実験する場合は、未検証として扱い、手動でのトラブルシューティングを想定してください
Cloud vs Standalone の期待値
Cloud
次が必要なときは Cloud を使ってください:
- ローカルネットワークの外からのアクセス
- プッシュ通知
- マルチマシン管理
- API キーと Webhook
Standalone
次が必要なときは Standalone を使ってください:
- ローカル専用のセットアップ
- クラウド依存なし
- LAN ベースのモニタリングと制御
Standalone は OSS ユーザーやローカルチームには最適ですが、プッシュ通知やインターネット向けのリモートアクセスのようなクラウド専用機能は、その経路の一部ではありません。
今日、通常最もうまく機能するもの
製品の最も代表的な第一印象が欲しいなら、特定のプロバイダーの格上げ状態に依存しない一般的なアプローチは次のとおりです:
- ネイティブ制御、モバイル承認、Remote View が欲しいなら、デスクトップ IDE ワークフローを選ぶ
- 特定の拡張機能統合が欲しい場合にのみ、拡張機能ワークフローを選ぶ
- 最もシンプルで直接的なワークフローが欲しいなら、ダッシュボードのターミナルを通じた CLI エージェントを選ぶ
- まず 1 台のマシンに 1 つのプロバイダー、基本が安定して感じられたらマルチマシン
現在のステータスを確認する場所
現在の格上げされたリストとカテゴリごとのステータスは、対応プロバイダー を使ってください。そのページは、単にインベントリに存在するものと、明示的な検証が裏付けられているものについての公開リファレンスです。