문제 해결
대시보드가 머신과 동기화되지 않거나, 세션이 사라지거나, 호스팅 CLI 런타임을 복구해야 할 때 이 페이지를 사용하세요.
대시보드에 아무것도 표시되지 않음
대시보드에 머신이나 세션이 없다고 표시되면 먼저 로컬 데몬을 확인하세요:
adhdev daemon:status다음을 확인하세요:
- 실행 중인 데몬 프로세스
- 도달 가능한 로컬 IPC
- CLI 에이전트를 사용하는 경우 세션-호스트 상태
데몬이 실행되지 않는다면 다시 시작하거나, 보통 그 방식으로 ADHDev를 실행한다면 백그라운드 서비스를 다시 설치하세요.
IDE 또는 에이전트가 없음
무엇이든 다시 실행하기 전에, 이제 덜 긴급한 작업을 숨기는 대시보드 표면을 확인하세요:
- 숨김 탭
- 활동 인박스
- 히스토리
머신이 연결되어 있지만 특정 IDE 세션이 없는 경우 ADHDev를 통해 해당 IDE를 다시 실행하여 예상 제어 표면으로 시작되도록 하세요:
adhdev launch cursorIDE에 맞는 대상을 사용하세요.
채팅이 비어 있거나 로딩 중에 멈춤
세션은 존재하지만 채팅이 비어 있거나 여전히 로딩 중인 경우:
- 세션 스트림이 안정화될 때까지 몇 초 기다리세요.
- 탭 스트립, 인박스, 또는 히스토리에서 세션을 다시 여세요.
- 원래 IDE 또는 CLI 도구가 여전히 실행 중인지 확인하세요.
- CLI 런타임인 경우 즉시 중복 세션을 실행하는 대신 세션 호스트를 검사하세요.
CLI 집약적인 설정에서 누락된 채팅은 종종 런타임이 살아남았지만 대시보드가 다시 연결해야 한다는 것을 의미합니다.
세션이 "생성 중" 상태에서 영영 멈춘 것 같음
CLI 세션이 작업이 걸릴 만한 시간보다 훨씬 오래 "생성 중"으로 표시된다면, 먼저 해당 에이전트의 무진행 알림 설정(대시보드 기어 버튼)을 확인하세요 — 턴이 임계값을 넘어가면 알림을 발생시키며, 단순히 긴 턴이 아니라 뭔가 잘못됐다는 첫 실질적 신호인 경우가 많습니다. 터미널 자체가 멈추거나 깨진 것처럼 보인다면(특정 도구 출력 이후 Antigravity CLI에서 가장 흔히 나타남) 세션을 다시 열어보세요 — ADHDev가 다시 그리기를 유도하고 실제 상태를 재확인합니다. 그래도 여전히 멈춰 있다면, 강제로 닫고 중복 세션을 다시 실행하는 대신 위의 세션-호스트 복구 경로를 사용하세요.
CLI 프로바이더를 실행할 수 없음
런처에 사용 가능한 CLI 프로바이더가 없다고 나오거나 내장 프로바이더가 실행에서 없는 경우:
- 머신의 Providers 탭을 엽니다.
- 해당 머신에서 프로바이더를 활성화합니다.
- Detect를 실행하고 프로바이더 카드의 감지/검증 상세 정보를 읽으세요.
- 업스트림 바이너리가 기본 PATH 외부에 설치된 경우 사용자 정의 실행 파일 경로/인수를 설정하세요.
- 프로바이더 소스 모드나 providerDir를 변경한 경우 새 실행을 시도하기 전에 Apply + Reload를 클릭하세요.
내장 프로바이더 인벤토리는 의도적으로 머신 실행 가능성과 분리되어 있습니다. 프로바이더는 로컬 활성화와 감지가 성공한 후에만 실행 가능해집니다.
재시작 후 CLI 세션이 멈춤
호스팅 CLI 런타임에는 이제 전용 복구 경로가 있습니다.
먼저 세션-호스트 상태를 검사하세요:
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 상태에서 멈춘 경우
- 동일 세션에 대해 중복 호스팅 런타임이 생성된 경우
- 런타임은 존재하지만 대시보드가 잘못된 복사본에 연결된 경우
Remote View를 사용할 수 없음
Remote View가 비어 있거나 CDP 경고를 표시하는 경우:
adhdev launch <ide>를 통해 IDE를 다시 실행하세요.- IDE가 ADHDev가 잘 제어할 수 있는 Electron 기반 흐름 중 하나인지 확인하세요.
- 네트워크 또는 브라우저가 라이브 연결을 방해하고 있는지 확인하세요.
나머지 세션은 작동하지만 Remote View가 작동하지 않는다면, 일반적인 대시보드 실패가 아닌 IDE 제어 표면 문제로 먼저 취급하세요.
CLI 세션이 유휴 상태처럼 보이지만 전혀 응답하지 않음
CLI 세션이 즉시 아무것도 아닌 것으로 응답하거나, 실제로는 사용할 수 없는데 유휴 상태처럼 보인다면, 기본 도구의 로그인이 만료됐는지 확인하세요 — 흔한 원인은 CLI 자체가 보고한 만료된 로그인/세션/자격 증명입니다("Login expired", "session has expired" 등). ADHDev는 세션 단위로 이를 감지하여 정상적인 유휴 워커처럼 보이게 두는 대신 세션을 오류로 표시합니다. 도구 자체를 재인증한 후(도구 자체의 로그인 명령), 세션을 다시 실행하거나 재연결하세요.
Repo Mesh가 디스패치 중 프로바이더를 건너뜀
Repo Mesh 태스크가 예상했던 노드에 의해 클레임되지 않는다면, 해당 노드의 프로바이더가 현재 쿼터/사용량 한도 소진을 보고하고 있는지 확인하세요(adhdev quota <provider>). 메시 큐는 최신 확인 결과 소진된 것으로 보이는 프로바이더에 새 작업을 의도적으로 디스패치하지 않고, 대신 다른 유휴 노드로 라우팅합니다. 쿼터가 재설정되거나(또는 adhdev quota refresh <provider>를 실행하면) 해당 노드는 다시 대상이 됩니다.
업데이트 중 Windows 콘솔 창이 깜빡임 (1.0.60에서 부분 수정)
Windows에서 adhdev update 실행 중과 데몬이 새 버전으로 재시작된 직후에 콘솔 창이 잠깐 깜빡일 수 있습니다. 1.0.60은 업데이트 파이프라인 자체(npm install, atomic install 교체, 헬스체크 폴링)에서 발생하는 깜빡임을 제거했고, 업그레이드된 데몬이 시작된 직후 설치된 CLI 프로바이더마다 한 번씩 뜨던 깜빡임(각 CLI의 --version을 프로브함)도 함께 수정했습니다. 여전히 알려져 있고 작업 중인 깜빡임이 하나 있습니다: 세션이 중지될 때 뜨는 node.exe 창으로, 자체적으로 창 숨김 옵션이 없는 서드파티 라이브러리 호출에서 발생합니다. 이는 겉모습일 뿐이며 — 세션 중지는 여전히 정상적으로 완료됩니다. 다른 시점에 깜빡임을 목격한다면 창 제목과 함께 신고해 주세요.
알림이 오지 않음
대시보드에서 Notifications를 열고 다음을 확인하세요:
- 글로벌 알림이 활성화됨
- 브라우저 알림이 활성화됨
- 호스팅 클라우드 경로를 사용한다면 푸시 알림이 활성화됨
- 프로바이더 수준 알림 설정이 예상하는 이벤트를 억제하지 않음
푸시 알림은 클라우드 전용이며 모바일에서 ADHDev가 PWA로 설치된 경우 가장 잘 작동합니다.
모바일 대시보드가 멈춘 것 같음
모바일 브라우저는 백그라운드 탭을 더 공격적으로 중단합니다.
시도해 보세요:
- 당겨서 새로고침
- 인박스에서 활성 세션 다시 열기
- 연결이 복구되지 않으면 탭 완전히 다시 열기
승인만 확인하면 된다면 이전 채팅 뷰가 자체 복원되기를 기다리는 것보다 인박스가 보통 더 신뢰할 수 있습니다.
여전히 문제가 있음
로컬 상태가 일관성 없어 보인다면 먼저 현재 상태를 수집하세요:
adhdev doctor
adhdev daemon:status
adhdev daemon:session-host --jsonadhdev doctor는 이제 PATH adhdev / adhmux 바이너리가 오래됐거나, 손상됐거나, 더 새로운 런타임 표면이 없는지도 확인합니다. runtime 명령이 문서와 일치하지 않는 것 같다면 세션-호스트/런타임 레이어가 잘못됐다고 가정하기 전에 doctor 출력을 확인하세요.
그런 다음 확인하세요:
~/.adhdev/logs/의 데몬 로그- 대시보드의 머신 Logs 탭
- 중단된 런타임을 위한 머신 Hosted Runtimes 탭
최후 수단
설치 자체가 손상된 경우 깨끗한 재설치가 여전히 폴백입니다:
adhdev uninstall -f
npm uninstall -g adhdev
npm install -g adhdev
adhdev setup
adhdev service installWARNING
이렇게 하면 인증 상태, 로그, 캐시된 설정을 포함한 로컬 ADHDev 데이터가 제거됩니다.