互換性と注意事項
ADHDev は幅広い組み込みプロバイダーインベントリを提供していますが、互換性は依然として保守的に読むべきです。このページは、特定のワークフローに依存する前に期待値を設定する最速の方法です。
インベントリが第一、検証が第二
次の経験則に従ってください:
- 組み込みとは、プロバイダーが出荷されたインベントリに存在することを意味します。
- 検証済みとは、プロバイダーが手動でテストされ、格上げされたことを意味します。
- プロバイダーが格上げされるまでは、ランチャー、ドキュメント、または機能ページに表示されていても未検証として扱ってください。
実用的な出発点
実際の利用のために ADHDev を評価している場合は、単にインベントリに存在するだけのものではなく、すでに公開の Partial の証拠を持つプロバイダーから始めてください。
IDE ワークフロー
- Cursor
Cursor は現在、IDE スタイルの制御、Remote View、セッション切り替えのための最も明確な公開の出発点です。
拡張機能ワークフロー
- Codex 拡張機能
これは現在、最も強力な公開の証拠を持つ拡張機能の経路です。他の拡張機能はインベントリや起動サーフェスに表示されることがありますが、格上げされるまでは探索的なものとして扱うべきです。
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 アダプターは、自身のツールで依然として実験的とマークされているアップストリームの機能に依存しています。
- Gemini CLI（ACP）は現在
--experimental-acpで起動します - Qwen Code（ACP）は現在
--experimental-skillsで起動します
これらは依然として有用な場合がありますが、デフォルトで安全な選択肢ではなく、実験的なものとして扱うべきです。
認証は依然としてツール固有
ADHDev は各ツール自身のログインフローを置き換えません。
- CLI および ACP エージェントは、依然として自身の API キーやログイン状態を必要とします
- 基盤となるツールをまだ認証していない場合、API キーの欠如は起動失敗のように見えることがあります
- これは Gemini、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 ユーザーやローカルチームには最適ですが、プッシュ通知やインターネット向けのリモートアクセスのようなクラウド専用機能は、その経路の一部ではありません。
今日、通常最もうまく機能するもの
製品の最も代表的な第一印象が欲しいなら、次が依然として最も安全な出発経路です:
- デスクトップの Cursor、オプションでモバイル承認や Remote View と組み合わせて
- 拡張機能ワークフローが特に欲しい場合は、サポートされたホスト IDE 内の Codex 拡張機能
- ダッシュボードのターミナルを通じた Claude Code または Codex CLI
- まず 1 台のマシンに 1 つの IDE、基本が安定して感じられたらマルチマシン
現在のステータスを確認する場所
現在の格上げされたリストとカテゴリごとのステータスは、対応プロバイダー を使ってください。そのページは、単にインベントリに存在するものと、明示的な検証が裏付けられているものについての公開リファレンスです。