トラブルシューティング

ダッシュボードがマシンと同期していないように見えるとき、セッションが消えるとき、またはホスト型 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 プロバイダーを起動できない

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

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 の制御サーフェスの問題として扱ってください。

通知が届かない

ダッシュボードで 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