トラブルシューティング

ダッシュボードがマシンと同期していないように見えるとき、セッションが消えるとき、またはホスト型 CLI ランタイムの復旧が必要なときに、このページを使ってください。

ダッシュボードに何も表示されない

ダッシュボードにマシンやセッションがないと表示される場合は、まずローカルデーモンを確認してください:

adhdev daemon:status

次を確認します:

• 実行中のデーモンプロセス
• 到達可能なローカル IPC
• CLI エージェントを使う場合は session-host のステータス

デーモンが実行されていない場合は、再度起動するか、通常その方法で ADHDev を実行しているならバックグラウンドサービスを再インストールしてください。

IDE またはエージェントがない

何かを再起動する前に、緊急性の低い作業を隠すようになったダッシュボードのサーフェスを確認してください:

• 非表示タブ
• アクティビティインボックス
• History

マシンは接続されているのに特定の IDE セッションがない場合は、期待される制御サーフェスで起動するように、ADHDev を通じてその IDE を再起動してください:

adhdev launch cursor

お使いの IDE に合ったターゲットを使ってください。

チャットが空、または読み込みで止まっているように見える

セッションは存在するのにチャットが空白、またはまだ読み込み中の場合:

1. セッションストリームが安定するまで数秒待ちます。
2. タブストリップ、インボックス、または履歴からセッションを再度開きます。
3. 元の IDE または CLI ツールがまだ実行中か確認します。
4. CLI ランタイムの場合は、すぐに重複セッションを起動する代わりに session host を検査します。

CLI を多用するセットアップでは、チャットの欠如は、多くの場合ランタイムは生き残っているがダッシュボードが再接続する必要があることを意味します。

セッションが「生成中」のまま止まっているように見える

CLI セッションがタスクにかかるはずの時間よりはるかに長く「生成中」と表示されている場合は、まずそのエージェントの 進捗なしアラート 設定（ダッシュボードの歯車ボタン）を確認してください — これはターンがしきい値を超えて実行されたときに通知を発火します。単なる長いターンではなく何かがおかしいことを示す最初の実際の信号であることが多いです。ターミナル自体がフリーズしたり文字化けしたりしているように見える場合（特定のツール出力の後の Antigravity CLI で最もよく見られます）は、セッションを再度開いてください — ADHDev は再描画を促し、実際のステータスを再確認します。それでもまだ止まっている場合は、強制的に閉じて重複を再起動するのではなく、上記の session-host 復旧経路を使ってください。

CLI プロバイダーを起動できない

ランチャーに使用可能な CLI プロバイダーがないと表示される場合、または組み込みプロバイダーが起動から欠けている場合:

1. マシンの Providers タブを開きます。
2. そのマシンでプロバイダーを有効化します。
3. Detect を実行し、プロバイダーカードの検出/検証の詳細を読みます。
4. アップストリームのバイナリがデフォルトの PATH の外にインストールされている場合は、カスタムの実行ファイルパス/引数を設定します。
5. プロバイダーソースモードや providerDir を変更した場合は、新しい起動を試す前に Apply + Reload をクリックします。

組み込みプロバイダーインベントリは、意図的にマシンの起動可能性とは分離されています。プロバイダーは、ローカルの有効化と検出が成功した後にのみ起動可能になります。

再起動後に CLI セッションが止まっている

ホスト型 CLI ランタイムには、専用の復旧経路があります。

まず session-host の状態を検査します:

adhdev daemon:session-host

一般的な復旧アクション:

adhdev daemon:session-host --session <sessionId> --resume
adhdev daemon:session-host --session <sessionId> --restart
adhdev daemon:session-host --prune-duplicates

ダッシュボードのマシンの Hosted Runtimes タブからも同じことができます。

次のような場合に使ってください:

• CLI セッションがデーモンの再起動を生き延びた場合
• ランタイムが interrupted 状態で止まっている場合
• 同じセッションに対して重複するホスト型ランタイムが作成された場合
• ランタイムは存在するのに、ダッシュボードが間違ったコピーに接続されている場合

リモートビューが利用できない

リモートビューが空白、または CDP 警告を表示する場合:

1. adhdev launch <ide> を通じて IDE を再起動します。
2. IDE が、ADHDev がうまく制御できる Electron ベースのフローの 1 つであることを確認します。
3. ネットワークまたはブラウザがライブ接続を妨げていないか確認します。

セッションの残りは動作するのにリモートビューが動作しない場合は、一般的なダッシュボードの障害ではなく、まず IDE の制御サーフェスの問題として扱ってください。

CLI セッションがアイドルに見えるのに反応がない

CLI セッションが何もないのに即座に答えているように見える、またはそれ以外の形で実際には使用できないままアイドルに見える場合は、基盤となるツールのログインが期限切れになっていないか確認してください — よくある原因は、CLI 自身が報告した期限切れのログイン/セッション/認証情報（「Login expired」、「session has expired」など）です。ADHDev はこれをセッションごとに検出し、健全なアイドルワーカーのように見せる代わりにセッションをエラーとしてマークします。ツール自体を再認証し（そのツール自身のログインコマンド）、その後セッションを再起動または再接続してください。

Repo Mesh がディスパッチ中にプロバイダーをスキップする

期待していたノードによって Repo Mesh タスクが一度もクレームされない場合は、そのノードのプロバイダーが現在クォータ/使用制限の枯渇を報告していないか確認してください（adhdev quota <provider>）。Mesh キューは、枯渇しているという最新の読み取り値を持つプロバイダーには意図的に新しい作業をディスパッチせず、代わりに別のアイドルノードにルーティングします。クォータがリセットされる（または adhdev quota refresh <provider> を実行する）と、そのノードは再び対象になります。

Windows でアップデート中にコンソールウィンドウがフラッシュする（1.0.60 で部分的に修正）

Windows では、adhdev update の実行中、およびデーモンが新しいバージョンで再起動した直後に、コンソールウィンドウが一瞬フラッシュすることがあります。1.0.60 は、アップデートパイプライン自体（npm インストール、アトミックインストールの入れ替え、ヘルスチェックのポーリング）からフラッシュを取り除き、アップグレードされたデーモンが起動した直後にインストール済みの各 CLI プロバイダーにつき 1 回発生していたフラッシュ（各 CLI の --version をプローブするため）も修正しました。まだ既知で対応中のフラッシュが 1 つ残っています: セッションが停止されるときの node.exe ウィンドウで、ウィンドウを隠すオプションを持たないサードパーティライブラリの呼び出しに起因します。これは見た目だけの問題です — セッションの停止は正常に完了します。それ以外のタイミングでフラッシュを見た場合は、ウィンドウタイトルとともに報告してください。

通知が届かない

ダッシュボードで Notifications を開き、次を確認してください:

• グローバル通知が有効になっている
• ブラウザ通知が有効になっている
• ホスト型クラウド経路を使う場合はプッシュ通知が有効になっている
• プロバイダーレベルのアラート設定が、期待するイベントを抑制していない

プッシュ通知はクラウド専用で、ADHDev がモバイルで PWA としてインストールされているときに最もよく機能します。

モバイルダッシュボードが固まったように感じる

モバイルブラウザは、バックグラウンドタブの中断についてより積極的です。

試してみてください:

1. 引っ張って更新
2. インボックスからアクティブなセッションを再度開く
3. 接続が復旧しなかった場合はタブを完全に開き直す

承認を確認したいだけなら、以前のチャットビューが自ら復元するのを待つよりも、通常インボックスの方が信頼できます。

まだ壊れている

ローカルの状態に一貫性がないように見える場合は、まず現在のステータスを収集してください:

adhdev doctor
adhdev daemon:status
adhdev daemon:session-host --json

adhdev doctor は今や、PATH 上の adhdev / adhmux バイナリが古くなっていないか、壊れていないか、より新しいランタイムサーフェスを欠いていないかも確認します。runtime コマンドがドキュメントと一致しないように見える場合は、session-host/ランタイムレイヤーが間違っていると決めつける前に doctor の出力を確認してください。

その後、次を確認してください:

• ~/.adhdev/logs/ のデーモンログ
• ダッシュボードのマシンの Logs タブ
• 中断されたランタイムのためのマシンの Hosted Runtimes タブ

最終手段

インストール自体が破損している場合は、クリーンな再インストールが依然としてフォールバックです:

adhdev uninstall -f
npm uninstall -g adhdev
npm install -g adhdev
adhdev setup
adhdev service install

WARNING

これにより、認証状態、ログ、キャッシュされた設定を含むローカルの ADHDev データが削除されます。

ヘルプを得る

• 互換性と注意事項
• ダッシュボード
• CLI エージェント
• Self-hosted
• GitHub Issues: github.com/vilmire/adhdev/issues