CLI 명령어

최종 사용자용 adhdev 커맨드라인 도구 레퍼런스.

전역 명령어

`adhdev`

도움말과 사용 가능한 명령어를 표시합니다.

`adhdev setup`

대화형 설정 마법사. ADHDev Cloud에 머신을 인증합니다.

bash

adhdev setup
# 디바이스 인증을 위해 브라우저가 열림
# 토큰은 ~/.adhdev/config.json 에 저장됨

`adhdev daemon`

데몬 프로세스를 시작합니다. IDE에 연결하고 ADHDev 서버에 접속합니다.

bash

adhdev daemon
# 포그라운드에서 실행, 중지하려면 Ctrl+C

로컬 전용 스탠드얼론 서버를 원한다면 셀프호스트 문서를 참고하세요:

`adhdev standalone`

셀프호스트 스탠드얼론 서버를 시작합니다: 로컬 대시보드 + 내장 데몬 + 스탠드얼론 세션-호스트 네임스페이스.

bash

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`

현재 데몬 상태와 로컬 상태 정보를 표시합니다.

bash

adhdev daemon:status
adhdev daemon:status --port 19222

이 명령어는 다음을 보고합니다:

데몬 PID와 로그 경로
로컬 IPC 도달 가능성
CLI 에이전트 사용 시 세션-호스트 상태
데몬 IPC를 사용할 수 없을 때 직접 폴백 상태

`adhdev status`

현재 머신 설정 상태를 표시합니다.

bash

adhdev status

데몬/런타임 진단이 아니라 "이 머신이 설정되어 있고 로그인되어 있는지?" 에 대한 빠른 답을 원할 때 사용하세요.

`adhdev mcp`

Claude Desktop 같은 MCP 클라이언트가 ADHDev 세션을 검사하고 제어할 수 있도록 stdio를 통해 ADHDev MCP 서버를 시작합니다.

bash

# 로컬 모드: localhost:3847의 스탠드얼론 데몬과 통신
adhdev mcp
adhdev mcp --port 4000
adhdev mcp --password my-standalone-password

# Mesh 모드: 데몬 IPC를 통한 코디네이터 범위 도구
adhdev mcp --mode ipc --repo-mesh mesh_abc123

Claude Desktop 스타일 설정:

json

{
  "mcpServers": {
    "adhdev": {
      "command": "adhdev",
      "args": ["mcp"]
    }
  }
}

사용 가능한 도구:

모드	도구
로컬 스탠드얼론	`list_sessions`, `read_chat`, `send_chat`, `approve`, `screenshot`, `git_status`
Mesh (`--repo-mesh`)	코디네이터 범위 `mesh_*` 도구 세트

옵션:

플래그	설명
`--mode <mode>`	MCP 전송 모드: `local` 또는 `ipc`
`--repo-mesh <mesh_id>`	Mesh 모드로 시작 (코디네이터 범위 도구)
`--port <n>`	로컬 모드를 위한 스탠드얼론 데몬 포트 (기본값: `3847`)
`--password <pass>`	설정된 경우 스탠드얼론 데몬 비밀번호/토큰

실행 명령어

`adhdev launch [target]`

CDP 활성화로 IDE를 실행하거나 재실행하거나, 실행 중인 데몬을 통해 CLI 에이전트를 시작합니다.

CLI 프로바이더의 경우 일반 실행은 기본적으로 새 세션입니다. 재개/복구는 저장된 세션을 명시적으로 선택하거나 의도적으로 호스팅 런타임 복구를 사용할 때만 발생해야 합니다.

bash

# 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 에이전트
adhdev daemon                 # 데몬을 한 번 시작
adhdev launch gemini          # Gemini CLI 세션 실행
adhdev launch claude          # Claude Code 세션 실행
adhdev launch codex           # Codex CLI 세션 실행
adhdev launch aider           # Aider 세션 실행
adhdev launch cursor-cli      # Cursor CLI 세션 실행
adhdev launch github-copilot-cli # GitHub Copilot CLI 세션 실행
adhdev launch goose           # Goose 세션 실행
adhdev launch opencode        # OpenCode 세션 실행

옵션:

플래그	설명
`-w, --workspace <path>`	특정 워크스페이스/폴더 열기
`-n, --new-window`	새 창으로 열기

WARNING

IDE의 경우 adhdev launch는 기존 IDE 프로세스를 닫고 CDP 활성화 상태로 다시 엽니다. 먼저 작업을 저장하세요.

히스토리 명령어

`adhdev history list <provider>`

프로바이더에 대한 저장된 프로바이더 네이티브 CLI/ACP 히스토리를 나열합니다.

bash

adhdev history list claude
adhdev history list hermes-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]`

프로바이더 네이티브 저장 히스토리 세션을 재개합니다.

bash

adhdev history resume claude 20260414_101931_38d017
adhdev history resume hermes-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`

원시 세션-호스트 진단 대신 라이브/복구/비활성 그룹을 사용하여 호스팅 런타임 복구 및 진단 상태를 나열합니다.

bash

adhdev runtime list
adhdev runtime list --all
adhdev runtime list --json

기본적으로 레코드를 다음으로 그룹화합니다:

라이브 런타임
복구 스냅샷
--all이 요청될 때 비활성 레코드

다음에 답하고 싶을 때 먼저 사용하세요:

"지금 실제로 라이브인 것은?"
"복구할 수 있는 것은?"
"어떤 레코드가 단순히 오래된 스냅샷인가?"

`adhdev runtime attach <runtimeTarget>`

현재 터미널을 라이브 호스팅 런타임에 직접 연결합니다.

bash

adhdev runtime attach <runtimeTarget>
adhdev runtime attach <runtimeTarget> --read-only
adhdev runtime attach <runtimeTarget> --takeover

이 명령어는 라이브 런타임만 허용합니다. 대상이 복구 스냅샷이거나 비활성 중지 레코드인 경우, 대상이 연결 가능한 척하는 대신 빠르게 실패하고 복구하거나 재시작하라고 알려줍니다.

`adhdev runtime open <runtimeTarget>`

라이브 호스팅 런타임을 위한 adhmux 워크스페이스를 엽니다.

bash

adhdev runtime open <runtimeTarget>
adhdev runtime open <runtimeTarget> --read-only
adhdev runtime open <runtimeTarget> --workspace review-pane

고급 mux/패널 워크플로우를 명시적으로 원할 때 사용하세요. 일반 터미널 연결 및 복구 흐름은 여전히 adhdev runtime attach, adhdev runtime recover, 또는 adhdev runtime restart로 시작해야 합니다.

`adhdev runtime recover <runtimeTarget>`

호스팅 런타임 레코드를 복구하거나 재개합니다.

bash

adhdev runtime recover <runtimeTarget>
# 별칭
adhdev runtime resume <runtimeTarget>

`adhdev runtime restart <runtimeTarget>`

호스팅 런타임 레코드를 재시작합니다.

bash

adhdev runtime restart <runtimeTarget>

`adhdev runtime stop <runtimeTarget>`

호스팅 런타임 레코드를 중지합니다.

bash

adhdev runtime stop <runtimeTarget>

`adhdev runtime snapshot <runtimeTarget>`

호스팅 런타임 레코드의 최신 터미널 스냅샷을 출력합니다.

bash

adhdev runtime snapshot <runtimeTarget>
adhdev runtime snapshot <runtimeTarget> --json

<runtimeTarget>은 세션 ID, 런타임 키, 표시 이름, 또는 adhdev runtime list의 고유 접두사일 수 있습니다.

이것은 호스팅 런타임 복구 및 진단 표면입니다. 중단 후 런타임 프로세스 자체를 복구해야 할 때 사용하세요. 프로바이더 대화 히스토리를 계속하는 일반적인 방법이 아닙니다.

가장 일반적인 두 가지 런타임 작업에는 최상위 단축키도 있습니다:

bash

adhdev attach <runtimeTarget>
adhdev recover <runtimeTarget>
adhdev resume <runtimeTarget>

이는 adhdev runtime attach와 adhdev runtime recover의 직접 단축키입니다.

세션 호스트 명령어

`adhdev daemon:session-host`

로컬 세션 호스트를 검사하고 제어합니다.

adhdev runtime ... 뒤의 고급 진단 및 오퍼레이터 제어 표면입니다. 대부분의 사용자가 먼저 런타임 표면으로 시작해야 하기 때문에 기본 CLI 도움말에서 의도적으로 de-emphasized되어 있습니다.

bash

# 진단 스냅샷 표시
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 백그라운드 서비스로 등록합니다.

bash

adhdev service install

플랫폼	방법
macOS	LaunchAgent plist (`~/Library/LaunchAgents/dev.adhf.daemon.plist`)
Windows	시작 폴더의 VBScript (숨겨진 콘솔 창)
Linux	내장 자동 설치 도우미 없음

데몬이 충돌하면 자동으로 재시작하지만, 깨끗하게 종료되면 재시작 루프가 없습니다 (예: 다른 인스턴스가 이미 실행 중일 때).

`adhdev service uninstall`

OS 백그라운드 서비스를 제거합니다. 현재 실행 중인 데몬에는 영향을 주지 않습니다 — adhdev daemon:stop으로 별도로 중지하세요.

bash

adhdev service uninstall

`adhdev service status`

서비스 등록 상태와 라이브 데몬 상태(PID, 가동 시간, 메모리, 로그 크기)를 표시합니다.

bash

adhdev service status
# ✓ Service is installed.
# ✓ Daemon running — PID 12723, uptime 2h 13m, 58 MB
# Logs: stdout 4.2 KB, stderr 0 B

`adhdev service logs`

실시간으로 데몬 서비스 로그를 봅니다 (tail -f).

bash

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가 넘는 로그도 교체합니다.

bash

adhdev service restart

계정 및 데이터

`adhdev logout`

ADHDev에서 로그아웃합니다. 인증 자격 증명을 지우지만 IDE 및 워크스페이스 설정은 유지합니다.

bash

adhdev logout
adhdev logout -f   # 확인 프롬프트 건너뜀

`adhdev reset`

ADHDev 구성을 재설정합니다. ~/.adhdev/config.json을 지우기 전에 확인을 요청합니다.

bash

adhdev reset

`adhdev uninstall`

시스템에서 ADHDev를 완전히 제거합니다. 데몬을 중지하고, OS 백그라운드 서비스를 제거하며, ~/.adhdev의 모든 데이터를 삭제합니다.

bash

adhdev uninstall
adhdev uninstall -f   # 확인 프롬프트 건너뜀

이 명령어는 다음 단계를 수행합니다:

중지 실행 중인 데몬 프로세스 (있는 경우)
제거 OS 백그라운드 서비스 (LaunchAgent / Startup 스크립트)
삭제 ~/.adhdev/ — 모든 구성, 인증 토큰, 로그, 캐시 데이터
npm uninstall -g adhdev로 마무리 지시사항 출력

WARNING

이 작업은 되돌릴 수 없습니다. 모든 설정, 자격 증명, 다운로드된 프로바이더가 영구적으로 삭제됩니다. 인증이나 구성만 지우려면 adhdev logout 또는 adhdev reset을 사용하세요.

버전 및 업그레이드

`adhdev --version`

현재 ADHDev 버전을 표시합니다.

`adhdev update`

ADHDev를 최신 버전으로 업그레이드하고 데몬을 재시작합니다. adhdev daemon:upgrade의 별칭.

bash

adhdev update
adhdev update --no-restart   # 업그레이드만, 데몬 재시작 건너뜀

`adhdev daemon:upgrade`

데몬을 최신 버전으로 업그레이드합니다.

bash

adhdev daemon:upgrade
# 최신 버전을 다운로드하여 설치

`adhdev daemon:api [mode]`

서버 REST API 릴레이 접근을 관리합니다. 기본적으로 비활성화 — 대시보드 트래픽은 항상 P2P/로컬 IPC를 사용합니다.

bash

adhdev daemon:api           # 현재 상태 표시
adhdev daemon:api enable    # 서버 측 REST 프록시 경로 허용
adhdev daemon:api disable   # 서버 측 REST 프록시 경로 취소

이것은 서버 API 프록시 경로에만 영향을 줍니다. 대시보드 명령/데이터 플레인은 이 설정에 관계없이 P2P 우선으로 유지됩니다.

고급 명령어

adhdev provider ..., adhdev cdp ..., adhdev daemon --dev 같은 명령어는 주로 진단, 프로바이더 작업, 또는 로컬 디버깅용입니다. 여기서는 의도적으로 일반 사용자 워크플로우에서 제외합니다.

CLI 명령어 ​

전역 명령어 ​

adhdev ​

adhdev setup ​

adhdev daemon ​

adhdev standalone ​

adhdev daemon:status ​

adhdev status ​

adhdev mcp ​

실행 명령어 ​

adhdev launch [target] ​

히스토리 명령어 ​

adhdev history list <provider> ​

adhdev history resume <provider> [historySessionId] ​

런타임 명령어 ​

adhdev runtime list ​

adhdev runtime attach <runtimeTarget> ​

adhdev runtime open <runtimeTarget> ​

adhdev runtime recover <runtimeTarget> ​

adhdev runtime restart <runtimeTarget> ​

adhdev runtime stop <runtimeTarget> ​

adhdev runtime snapshot <runtimeTarget> ​

세션 호스트 명령어 ​

adhdev daemon:session-host ​

서비스 관리 ​

adhdev service install ​

adhdev service uninstall ​

adhdev service status ​

adhdev service logs ​

adhdev service restart ​

계정 및 데이터 ​

adhdev logout ​

adhdev reset ​

adhdev uninstall ​

버전 및 업그레이드 ​

adhdev --version ​

adhdev update ​

adhdev daemon:upgrade ​

adhdev daemon:api [mode] ​

고급 명령어 ​

CLI 명령어

전역 명령어

`adhdev`

`adhdev setup`

`adhdev daemon`

`adhdev standalone`

`adhdev daemon:status`

`adhdev status`

`adhdev mcp`

실행 명령어

`adhdev launch [target]`

히스토리 명령어

`adhdev history list <provider>`

`adhdev history resume <provider> [historySessionId]`

런타임 명령어

`adhdev runtime list`

`adhdev runtime attach <runtimeTarget>`

`adhdev runtime open <runtimeTarget>`

`adhdev runtime recover <runtimeTarget>`

`adhdev runtime restart <runtimeTarget>`

`adhdev runtime stop <runtimeTarget>`

`adhdev runtime snapshot <runtimeTarget>`

세션 호스트 명령어

`adhdev daemon:session-host`

서비스 관리

`adhdev service install`

`adhdev service uninstall`

`adhdev service status`

`adhdev service logs`

`adhdev service restart`

계정 및 데이터

`adhdev logout`

`adhdev reset`

`adhdev uninstall`

버전 및 업그레이드

`adhdev --version`

`adhdev update`

`adhdev daemon:upgrade`

`adhdev daemon:api [mode]`

고급 명령어