CLI 명령어
최종 사용자용 adhdev 커맨드라인 도구 레퍼런스.
전역 명령어
adhdev
도움말과 사용 가능한 명령어를 표시합니다.
adhdev setup
대화형 설정 마법사. ADHDev Cloud에 머신을 인증합니다.
adhdev setup
# 디바이스 인증을 위해 브라우저가 열림
# 토큰은 ~/.adhdev/config.json 에 저장됨adhdev daemon
데몬 프로세스를 시작합니다. IDE에 연결하고 ADHDev 서버에 접속합니다.
adhdev daemon
# 포그라운드에서 실행, 중지하려면 Ctrl+C로컬 전용 스탠드얼론 서버를 원한다면 셀프호스트 문서를 참고하세요:
adhdev standalone
셀프호스트 스탠드얼론 서버를 시작합니다: 로컬 대시보드 + 내장 데몬 + 스탠드얼론 세션-호스트 네임스페이스.
adhdev standalone
adhdev standalone --host 0.0.0.0
adhdev standalone --port 8080
adhdev standalone --token mysecret
adhdev standalone --no-open
adhdev standalone --dev클라우드 연결 데몬 흐름 대신 셀프호스트/로컬 전용 경로를 명시적으로 원할 때 사용하세요.
주요 동작:
--host를 전달하지 않으면 기본적으로 localhost 전용으로 유지됩니다- 토큰 인증이나 대시보드 비밀번호 없이
0.0.0.0에 노출하면 스탠드얼론이 LAN에 대시보드가 열려 있다고 경고합니다 - 스탠드얼론은 기본적으로 자체 세션-호스트 네임스페이스를 사용하므로 동일 머신에서 클라우드 연결 데몬과 충돌하지 않습니다
셀프호스트 세부 사항은 다음을 참고하세요:
adhdev daemon:status
현재 데몬 상태와 로컬 상태 정보를 표시합니다.
adhdev daemon:status
adhdev daemon:status --port 19222이 명령어는 다음을 보고합니다:
- 데몬 PID와 로그 경로
- 로컬 IPC 도달 가능성
- CLI 에이전트 사용 시 세션-호스트 상태
- 데몬 IPC를 사용할 수 없을 때 직접 폴백 상태
adhdev status
현재 머신 설정 상태를 표시합니다.
adhdev status데몬/런타임 진단이 아니라 "이 머신이 설정되어 있고 로그인되어 있는지?" 에 대한 빠른 답을 원할 때 사용하세요.
adhdev mcp
Claude Desktop 같은 MCP 클라이언트가 ADHDev 세션을 검사하고 제어할 수 있도록 stdio를 통해 ADHDev MCP 서버를 시작합니다.
# 로컬 모드: localhost:3847의 스탠드얼론 데몬과 통신
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password
# Mesh 모드: 데몬 IPC를 통한 코디네이터 범위 도구
adhdev mcp --mode ipc --repo-mesh mesh_abc123
# 위임 워커 모드 (데몬이 실행, 최소 툴셋)
adhdev mcp --mode ipc --workerClaude Desktop 스타일 설정:
{
"mcpServers": {
"adhdev": {
"command": "adhdev",
"args": ["mcp"]
}
}
}사용 가능한 도구 (로컬/Mesh 모드): list_daemons, list_sessions, launch_session, stop_session, check_pending, read_chat, read_chat_debug, send_chat, approve, git_status, git_log, git_diff, git_checkpoint, git_push, screenshot. Mesh 모드(--repo-mesh)는 여기에 더해 코디네이터 범위 mesh_* 도구 세트를 노출합니다. --worker 모드는 위임 워커에게 필요한 최소한의 툴셋만 노출합니다.
옵션:
| 플래그 | 설명 |
|---|---|
--mode <mode> | MCP 전송 모드: local 또는 ipc |
--repo-mesh <mesh_id> | Mesh 모드로 시작 (코디네이터 범위 도구) |
--worker | 위임 워커 모드 — 최소한의 워커 툴셋만 노출 |
--port <n> | 로컬 모드를 위한 스탠드얼론 데몬 포트 (기본값: 3847) |
--password <pass> | 설정된 경우 스탠드얼론 데몬 비밀번호/토큰 |
실행 명령어
adhdev launch [target]
CDP 활성화로 IDE를 실행하거나 재실행하거나, 실행 중인 데몬을 통해 CLI 에이전트를 시작합니다.
CLI 프로바이더의 경우 일반 실행은 기본적으로 새 세션입니다. 재개/복구는 저장된 세션을 명시적으로 선택하거나 의도적으로 호스팅 런타임 복구를 사용할 때만 발생해야 합니다.
# IDE
adhdev launch cursor # Cursor 실행 (CDP 포트 9333)
adhdev launch antigravity # Antigravity 실행 (CDP 포트 9335)
adhdev launch windsurf # Windsurf 실행 (CDP 포트 9336)
adhdev launch vscode # VS Code 실행
adhdev launch kiro # Kiro 실행
# CLI 에이전트 (8개 내장)
adhdev daemon # 데몬을 한 번 시작
adhdev launch claude # Claude Code 세션 실행
adhdev launch codex-cli # Codex CLI 세션 실행
adhdev launch cursor-cli # Cursor CLI 세션 실행
adhdev launch opencode # OpenCode CLI 세션 실행
adhdev launch antigravity-cli # Antigravity CLI 세션 실행
adhdev launch grok-cli # Grok CLI 세션 실행
adhdev launch kimi # Kimi 세션 실행옵션:
| 플래그 | 설명 |
|---|---|
-w, --workspace <path> | 특정 워크스페이스/폴더 열기 |
-n, --new-window | 새 창으로 열기 |
-d, --dir <path> | CLI 에이전트의 작업 디렉터리(-w와는 별개, 기본값은 현재 디렉터리) |
WARNING
IDE의 경우 adhdev launch는 기존 IDE 프로세스를 닫고 CDP 활성화 상태로 다시 엽니다. 먼저 작업을 저장하세요.
히스토리 명령어
adhdev history list <provider>
프로바이더에 대한 저장된 프로바이더 네이티브 CLI 히스토리를 나열합니다.
adhdev history list claude
adhdev history list codex-cli --json
adhdev history list codex-cli --limit 10 --offset 10
adhdev history list claude --resumable
adhdev history list claude --sort oldest
adhdev history list claude --sort messages
adhdev history list claude --text "reply with exactly" --workspace remote_vs --model gpt-5.4다음을 실제 목표로 할 때 먼저 사용하세요:
- "어떤 대화를 계속할 수 있는가?"
- "원하는 컨텍스트가 어떤 프로바이더 히스토리에 있는가?"
- "재개 가능한 워크스페이스가 있는 저장된 세션은 무엇인가?"
이 명령어는 세션-호스트 런타임 레코드가 아닌 저장된 히스토리 메타데이터(providerSessionId, 워크스페이스, 미리보기, 메시지 수)를 읽습니다.
유용한 필터 및 정렬 모드:
--resumable→--dir없이 즉시 재개 가능한 항목만 표시--text <text>→ 제목 또는 미리보기 부분 문자열로 필터링--workspace <text>→ 워크스페이스 경로 부분 문자열로 필터링--model <text>→ 모델 부분 문자열로 필터링--sort recent→ 최신 활동 순 (기본값)--sort oldest→ 오래된 활동 순--sort messages→ 메시지 수 높은 순
adhdev history resume <provider> [historySessionId]
프로바이더 네이티브 저장 히스토리 세션을 재개합니다.
adhdev history resume claude 20260414_101931_38d017
adhdev history resume codex-cli 20260413_163128_d61494
adhdev history resume claude --dir /path/to/worktree # 생략 시 대화형으로 선택
adhdev history resume claude --resumable --sort messages
adhdev history resume claude --text "sonnet follow-up" --workspace remote_vs --model gpt-5.4이것은 일반 CLI 사용의 주요 연속성 경로입니다. 같은 프로바이더 대화를 계속하려면 런타임 연결/복구보다 이 방법을 선호하세요. historySessionId를 생략하면 ADHDev가:
- 재개 가능한 저장 히스토리 항목이 하나뿐이면 자동 선택하거나
- 재개 가능한 항목이 여러 개면 대화형 선택기를 엽니다.
대화형 선택기 제어:
--resumable→--dir이 아직 필요한 항목 숨기기--text <text>→ 제목 또는 미리보기 부분 문자열로 필터링--workspace <text>→ 워크스페이스 경로 부분 문자열로 필터링--model <text>→ 모델 부분 문자열로 필터링--sort recent|oldest|messages→history list와 동일한 정렬 의미론 사용
저장된 항목에 워크스페이스 메타데이터가 없으면 --dir을 명시적으로 전달하세요.
런타임 명령어
adhdev runtime list
원시 세션-호스트 진단 대신 라이브/복구/비활성 그룹을 사용하여 호스팅 런타임 복구 및 진단 상태를 나열합니다.
adhdev runtime list
adhdev runtime list --all
adhdev runtime list --json기본적으로 레코드를 다음으로 그룹화합니다:
- 라이브 런타임
- 복구 스냅샷
--all이 요청될 때 비활성 레코드
다음에 답하고 싶을 때 먼저 사용하세요:
- "지금 실제로 라이브인 것은?"
- "복구할 수 있는 것은?"
- "어떤 레코드가 단순히 오래된 스냅샷인가?"
adhdev runtime attach <runtimeTarget>
현재 터미널을 라이브 호스팅 런타임에 직접 연결합니다.
adhdev runtime attach <runtimeTarget>
adhdev runtime attach <runtimeTarget> --read-only
adhdev runtime attach <runtimeTarget> --takeover이 명령어는 라이브 런타임만 허용합니다. 대상이 복구 스냅샷이거나 비활성 중지 레코드인 경우, 대상이 연결 가능한 척하는 대신 빠르게 실패하고 복구하거나 재시작하라고 알려줍니다.
adhdev runtime open <runtimeTarget>
라이브 호스팅 런타임을 위한 adhmux 워크스페이스를 엽니다.
adhdev runtime open <runtimeTarget>
adhdev runtime open <runtimeTarget> --read-only
adhdev runtime open <runtimeTarget> --workspace review-pane
adhdev runtime open <runtimeTarget> -n review-pane # --workspace의 짧은 별칭고급 mux/패널 워크플로우를 명시적으로 원할 때 사용하세요. 일반 터미널 연결 및 복구 흐름은 여전히 adhdev runtime attach, adhdev runtime recover, 또는 adhdev runtime restart로 시작해야 합니다.
adhdev runtime recover <runtimeTarget>
호스팅 런타임 레코드를 복구하거나 재개합니다.
adhdev runtime recover <runtimeTarget>
# 별칭
adhdev runtime resume <runtimeTarget>adhdev runtime restart <runtimeTarget>
호스팅 런타임 레코드를 재시작합니다.
adhdev runtime restart <runtimeTarget>adhdev runtime stop <runtimeTarget>
호스팅 런타임 레코드를 중지합니다.
adhdev runtime stop <runtimeTarget>adhdev runtime snapshot <runtimeTarget>
호스팅 런타임 레코드의 최신 터미널 스냅샷을 출력합니다.
adhdev runtime snapshot <runtimeTarget>
adhdev runtime snapshot <runtimeTarget> --json<runtimeTarget>은 세션 ID, 런타임 키, 표시 이름, 또는 adhdev runtime list의 고유 접두사일 수 있습니다.
이것은 호스팅 런타임 복구 및 진단 표면입니다. 중단 후 런타임 프로세스 자체를 복구해야 할 때 사용하세요. 프로바이더 대화 히스토리를 계속하는 일반적인 방법이 아닙니다.
가장 일반적인 두 가지 런타임 작업에는 최상위 단축키도 있습니다:
adhdev attach <runtimeTarget>
adhdev recover <runtimeTarget>
adhdev resume <runtimeTarget>이는 adhdev runtime attach와 adhdev runtime recover의 직접 단축키입니다.
세션 호스트 명령어
adhdev daemon:session-host
로컬 세션 호스트를 검사하고 제어합니다.
adhdev runtime ... 뒤의 고급 진단 및 오퍼레이터 제어 표면입니다. 대부분의 사용자가 먼저 런타임 표면으로 시작해야 하기 때문에 기본 CLI 도움말에서 의도적으로 de-emphasized되어 있습니다.
# 진단 스냅샷 표시
adhdev daemon:session-host
# 기본이 아닌 데몬 IPC 포트 사용
adhdev daemon:session-host --port 19222
# 원시 진단 JSON 출력
adhdev daemon:session-host --json
# 호스팅 런타임 재시작
adhdev daemon:session-host --session <sessionId> --restart
# 런타임 재개
adhdev daemon:session-host --session <sessionId> --resume
# 런타임 중지
adhdev daemon:session-host --session <sessionId> --stop
# 신호 전송
adhdev daemon:session-host --session <sessionId> --signal SIGINT
# 멈춘 클라이언트 강제 분리
adhdev daemon:session-host --session <sessionId> --detach-client <clientId>
# 동일 프로바이더 세션의 오래된 중복 런타임 정리
adhdev daemon:session-host --prune-duplicates
# 쓰기 소유권 강제 획득
adhdev daemon:session-host --session <sessionId> --acquire-write <clientId> --owner-type user
# 쓰기 소유권 해제
adhdev daemon:session-host --session <sessionId> --release-write <clientId>호스팅 CLI 세션이 멈추거나 연결이 끊기거나 수동 복구가 필요할 때 사용하세요.
호스팅 런타임 복구는 의도적으로 명시적입니다. 일반 데몬 시작은 해당 동작을 직접 선택하지 않는 한 호스팅 CLI 세션을 자동으로 다시 열지 않습니다.
옵션:
| 플래그 | 설명 |
|---|---|
-p, --port <port> | 로컬 데몬 IPC 포트 |
--json | JSON 출력 |
--limit <count> | 포함할 최근 진단 항목 수 |
--session <sessionId> | 대상 런타임 세션 |
--restart | 대상 런타임 재시작 |
--resume | 대상 런타임 재개 |
--stop | 대상 런타임 중지 |
--signal <signal> | SIGINT 또는 SIGTERM 같은 신호 전송 |
--detach-client <clientId> | 특정 연결된 클라이언트 강제 분리 |
--prune-duplicates | 오래된 중복 호스팅 런타임 제거 |
--acquire-write <clientId> | 클라이언트의 쓰기 소유권 강제 획득 |
--release-write <clientId> | 클라이언트의 쓰기 소유권 해제 |
--owner-type <type> | --acquire-write의 소유자 유형: user 또는 agent |
세션-호스트와 데몬 상태가 동기화되지 않아 보이거나 런타임이 interrupted 상태에서 멈추거나 쓰기 소유권을 수동으로 복구해야 할 때 사용하세요.
서비스 관리
adhdev service install
ADHDev 데몬을 로그인 시 자동으로 시작되는 OS 백그라운드 서비스로 등록합니다.
adhdev service install| 플랫폼 | 방법 |
|---|---|
| macOS | LaunchAgent plist (~/Library/LaunchAgents/dev.adhf.daemon.plist) |
| Windows | 시작 폴더의 VBScript (숨겨진 콘솔 창) |
| Linux | 내장 자동 설치 도우미 없음 |
데몬이 충돌하면 자동으로 재시작하지만, 깨끗하게 종료되면 재시작 루프가 없습니다 (예: 다른 인스턴스가 이미 실행 중일 때).
adhdev service uninstall
OS 백그라운드 서비스를 제거합니다. 현재 실행 중인 데몬에는 영향을 주지 않습니다 — adhdev daemon:stop으로 별도로 중지하세요.
adhdev service uninstalladhdev service status
서비스 등록 상태와 라이브 데몬 상태(PID, 가동 시간, 메모리, 로그 크기)를 표시합니다.
adhdev service status
# ✓ Service is installed.
# ✓ Daemon running — PID 12723, uptime 2h 13m, 58 MB
# Logs: stdout 4.2 KB, stderr 0 Badhdev service logs
실시간으로 데몬 서비스 로그를 봅니다 (tail -f).
adhdev service logs # stdout 로그 팔로우
adhdev service logs --err # stderr 로그 팔로우
adhdev service logs -n 50 # 마지막 50줄 표시
adhdev service logs --clear # 모든 로그 파일 비우기adhdev service restart
OS 서비스를 통해 데몬을 재시작합니다. 현재 프로세스에 SIGTERM을 보내고 서비스 관리자(launchd / Windows 시작)가 다시 실행하도록 합니다. 10 MB가 넘는 로그도 교체합니다.
adhdev service restart계정 및 데이터
adhdev logout
ADHDev에서 로그아웃합니다. 인증 자격 증명을 지우지만 IDE 및 워크스페이스 설정은 유지합니다.
adhdev logout
adhdev logout -f # 확인 프롬프트 건너뜀adhdev reset
ADHDev 구성을 재설정합니다. ~/.adhdev/config.json을 지우기 전에 확인을 요청합니다.
adhdev resetadhdev uninstall
시스템에서 ADHDev를 완전히 제거합니다. 데몬을 중지하고, OS 백그라운드 서비스를 제거하며, ~/.adhdev의 모든 데이터를 삭제합니다.
adhdev uninstall
adhdev uninstall -f # 확인 프롬프트 건너뜀
adhdev uninstall --dry-run # 실제로 삭제하지 않고 삭제될 항목만 출력이 명령어는 다음 단계를 수행합니다:
- 중지 실행 중인 데몬 프로세스 (있는 경우)
- 제거 OS 백그라운드 서비스 (LaunchAgent / Startup 스크립트)
- 삭제
~/.adhdev/— 모든 구성, 인증 토큰, 로그, 캐시 데이터 npm uninstall -g adhdev로 마무리 지시사항 출력
WARNING
이 작업은 되돌릴 수 없습니다. 모든 설정, 자격 증명, 다운로드된 프로바이더가 영구적으로 삭제됩니다. 인증이나 구성만 지우려면 adhdev logout 또는 adhdev reset을 사용하세요.
버전 및 업그레이드
adhdev --version
현재 ADHDev 버전을 표시합니다.
adhdev update
ADHDev를 최신 버전으로 업그레이드하고 데몬을 재시작합니다. adhdev daemon:upgrade의 별칭.
adhdev update
adhdev update --no-restart # 업그레이드만, 데몬 재시작 건너뜀adhdev update와 adhdev daemon:upgrade 둘 다 이전 방식 호출과의 하위 호환을 위해 --channel <channel> 플래그도 받습니다 — 릴리스 채널이 이제 빌드 시점에 고정되므로 이 플래그는 지원 중단되었으며 조용히 무시됩니다.
adhdev daemon:upgrade
데몬을 최신 버전으로 업그레이드합니다.
adhdev daemon:upgrade
# 최신 버전을 다운로드하여 설치adhdev daemon:api [mode]
서버 REST API 릴레이 접근을 관리합니다. 기본적으로 비활성화 — 대시보드 트래픽은 항상 P2P/로컬 IPC를 사용합니다.
adhdev daemon:api # 현재 상태 표시
adhdev daemon:api enable # 서버 측 REST 프록시 경로 허용
adhdev daemon:api disable # 서버 측 REST 프록시 경로 취소이것은 서버 API 프록시 경로에만 영향을 줍니다. 대시보드 명령/데이터 플레인은 이 설정에 관계없이 P2P 우선으로 유지됩니다.
쿼터 명령어
adhdev quota <provider>
AI 코딩 에이전트의 남은 플랜 쿼터를 표시합니다. antigravity/agy, codex, grok, kimi는 프로바이더 자체의 사용량 API를 실시간으로 조회합니다 — 설치할 것이 없습니다.
adhdev quota antigravity # 별칭: agy
adhdev quota codex
adhdev quota grok
adhdev quota kimi
adhdev quota claude # 먼저 `adhdev quota claude:install` 필요Claude Code는 statusLine 훅을 통해서만 사용량 수치를 노출하므로, 이를 읽으려면 래퍼로 해당 슬롯을 점유해야 합니다. 이는 옵트인이며 자동으로 수행되지 않습니다:
adhdev quota claude:install # 별칭: claude-install — 기존 statusline을 래핑
adhdev quota claude:uninstall # 별칭: claude-uninstall — 원래 statusline 복원
adhdev quota claude:status # 래퍼 설정 여부 표시codex와 kimi는 install/uninstall/status 서브커맨드가 없습니다 — 실시간 API 조회에는 설정할 것이 없기 때문입니다.
adhdev quota refresh [providers...]
실행 중인 데몬에게 지금 프로바이더 쿼터를 다시 읽도록 요청하여, 데몬 자체 캐시가 만료되기를 기다리지 않고 대시보드와 메시 라우팅이 즉시 갱신된 수치를 보도록 합니다.
adhdev quota refresh # 모든 프로바이더 새로고침
adhdev quota refresh codex kimi # 특정 프로바이더 새로고침현재 자체 HTTP 429 쿨다운 상태인 프로바이더는 다시 조회되지 않습니다(다시 요청하면 스로틀이 연장되기 때문입니다). 대신 쿨다운이 해제되는 시간이 보고됩니다. claude와 codex는 쿨다운이 없는 로컬 파일 기반 프로바이더이며 항상 다시 읽습니다.
구성 명령어
adhdev config env set/unset/list
재시작과 업그레이드를 거쳐도 유지되는 데몬 범위의 env/기능 플래그 오버라이드를 저장하며, 다음 데몬 재시작 시(현재 실행 중인 프로세스가 아니라) 적용됩니다.
adhdev config env set ADHDEV_WORKER_MCP on
adhdev config env unset ADHDEV_WORKER_MCP
adhdev config env list이 표면은 기능 플래그 전용입니다 — 비밀, 토큰, 자격 증명처럼 보이는 키는 거부됩니다. 명시적인 process.env 값은 항상 저장된 오버라이드보다 우선합니다.
진단
adhdev doctor
설치 상태, 네이티브 의존성, CLI 경로 해석, 폴더 탐색 접근을 진단합니다.
adhdev doctor이는 (다른 것들 중에서도) 빌드 트랙, 네이티브 모듈 로딩(예: node-datachannel, sharp), 설치가 링크됨/개발용인지 일반 npm 전역 패키지인지, PATH 상의 CLI 바이너리 해석, 일반적인 폴더 탐색 루트에 대한 읽기 접근을 확인합니다. 이슈를 등록하기 전에 데몬이나 네이티브 의존성이 손상된 것처럼 보이면 먼저 이것을 사용하세요.
고급 명령어
adhdev provider ..., adhdev cdp ..., adhdev daemon --dev 같은 명령어는 주로 진단, 프로바이더 작업, 또는 로컬 디버깅용입니다. 여기서는 의도적으로 일반 사용자 워크플로우에서 제외합니다.
