CLI 에이전트

CLI 에이전트는 ADHDev의 주요 워크플로 중 하나입니다. 현재 ADHDev는 카탈로그에 8개의 내장 CLI 프로바이더를 제공합니다. 프로바이더가 활성화되고 대상 머신에서 감지된 후 데몬의 PTY/session-host 레이어를 통해 실행되므로, 터미널 출력을 보고, 대시보드에서 입력하고, 데스크탑이나 모바일에서 세션을 계속 진행할 수 있습니다.

WARNING

내장이 검증된 지원을 의미하지 않습니다. 프로바이더가 호환성 문서에서 명시적으로 승격되지 않는 한 미검증으로 취급하세요. 검증 상태는 현재 전면 재검증 중입니다 — 지원 프로바이더를 참조하세요.

내장 CLI 프로바이더

에이전트	명령어	검증 수준	설명
Antigravity CLI	adhdev launch antigravity-cli	미검증	Google의 Antigravity 터미널 에이전트
Claude Code	adhdev launch claude	미검증	Anthropic의 Claude 코딩 에이전트
Codex CLI	adhdev launch codex-cli	미검증	OpenAI의 Codex 터미널 에이전트
Cursor CLI	adhdev launch cursor-cli	미검증	Cursor의 터미널 에이전트 워크플로
Grok CLI	adhdev launch grok-cli	미검증	xAI의 Grok 터미널 에이전트
Kimi	adhdev launch kimi	미검증	Moonshot의 Kimi 코딩 에이전트
OpenCode CLI	adhdev launch opencode	미검증	오픈소스 터미널 코딩 에이전트

이 표에 없는 CLI 에이전트를 직접 연동하고 싶다면, 프로바이더 매니페스트로 직접 추가하는 방법을 커스텀 프로바이더에서 확인하세요.

CLI가 중요한 이유

CLI 에이전트는 종종 작업을 계속 진행하는 가장 빠른 방법입니다. 이유:

• 레포와 셸 워크플로에 가깝게 유지됨
• 원격 터미널 제어에서 잘 작동함
• IDE 특정 UI 오류 방지
• ADHDev가 재구성된 추상화가 아닌 정확한 터미널 세션을 스트리밍할 수 있음

오늘 가장 신뢰할 수 있는 원격 워크플로를 원한다면 CLI 에이전트가 보통 첫 번째로 검증할 경로입니다. 개별 프로바이더의 검증 상태는 현재 재검증 중입니다 — 특정 승격에 의존하기 전에 지원 프로바이더에서 현재 상태를 확인하세요.

CLI 에이전트 실행

# 강력한 기본 경로
adhdev daemon
adhdev launch claude
adhdev launch codex-cli
adhdev launch cursor-cli

# 추가 내장 CLI 프로바이더
adhdev launch antigravity-cli
adhdev launch grok-cli
adhdev launch kimi
adhdev launch opencode

실행 전에 머신의 Providers 탭에서 프로바이더가 활성화되어 있는지, 구성된 실행 파일에 대해 Detect가 성공하는지 확인하세요. 바이너리가 기본 PATH 밖에 있는 경우 먼저 커스텀 실행 파일 경로/인수를 설정하세요.

데몬이 PTY로 CLI 프로세스를 스폰하고, 출력을 대시보드로 스트리밍하고, 입력을 프로세스로 전달합니다.

일반 실행은 새 세션으로 처리됩니다. 연속성을 원하면 암묵적 자동 재개에 의존하는 대신 히스토리나 호스팅 런타임 복구 같은 명시적 재개 경로를 사용하세요.

WARNING

각 CLI 도구는 자체 인증을 처리합니다. ADHDev는 PTY 세션과 원격 제어 레이어를 관리하며, 업스트림 도구의 로그인 흐름은 관리하지 않습니다.

폴더 신뢰 사전 승인

kimi, grok-cli, codex-cli, claude-cli, antigravity-cli는 ADHDev에 폴더 신뢰 체계를 등록합니다. 그래서 새 디렉토리에서 처음 실행할 때 해당 도구의 일회성 "이 폴더를 신뢰하시겠습니까?" 프롬프트를 건너뜁니다. 신뢰는 대화형으로 승인했을 때 도구 자신이 기록하는 것과 동일한 신뢰 저장소를 사용해 사전 승인됩니다.

터미널 워크플로

ADHDev의 CLI 프로바이더는 이제 터미널 뷰를 기본 워크플로로 사용합니다. 즉, 터미널이 다음의 신뢰 근거입니다:

• 출력 및 진행 상황
• 승인 프롬프트
• 도구 실행 흐름
• 재연결 및 스크롤백 동작

터미널 뷰

CLI 에이전트는 xterm.js로 구동되는 완전한 대화형 터미널과 함께 대시보드에 표시됩니다:

• 완전한 TUI 렌더링 — 색상, 커서 이동, 진행 막대, 승인 프롬프트
• 원격 입력 — 대시보드에서 직접 입력
• 스크롤백 복원 — 재연결 후 PTY 버퍼가 재생됨
• 모바일 친화적 제어 — 빠른 승인과 간단한 감독에 실용적

세션 복구

CLI 런타임은 더 이상 일회성 실행으로 취급되지 않습니다. ADHDev는 호스팅 런타임 레이어를 유지하여 연결 해제나 데몬 재시작 후에도 세션을 복구할 수 있는 경우가 많습니다.

복구 경로는 운영자 주도입니다: 연속성을 원할 때 사용자는 재개/히스토리/호스팅 런타임 복구 작업을 명시적으로 선택해야 합니다. 일반적인 새 실행이 자동으로 이전 세션을 다시 열어서는 안 됩니다.

CLI 세션이 메인 대시보드에서 사라지면:

• 숨겨진 탭
• 활동 인박스
• 히스토리
• 머신의 Hosted Runtimes 탭

확인하세요.

명령줄 복구를 위해 기본 사용자 대면 런타임 서피스부터 시작하세요:

adhdev runtime list
adhdev runtime attach <runtimeTarget>
adhdev runtime recover <runtimeTarget>
adhdev runtime restart <runtimeTarget>
adhdev runtime snapshot <runtimeTarget>

<runtimeTarget>은 세션 ID, 런타임 키, 표시 이름, 또는 adhdev runtime list에 표시된 고유 접두사를 허용합니다.

일반적인 경로를 위해 더 짧은 명령을 원한다면, adhdev attach <runtimeTarget>과 adhdev recover|resume <runtimeTarget>이 동일한 런타임 서피스에 대한 직접 단축키입니다.

저수준 진단이나 명시적 운영자 제어가 필요한 경우:

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

이것은 런타임이 여전히 존재하지만 활성 대시보드 세션이 막히거나 잘못된 복사본에 연결된 경우에 적합한 경로입니다.

히스토리와 재개 깊이는 프로바이더마다 다릅니다. 내장 CLI가 깔끔하게 실행될 수 있지만 해당 경로가 명시적으로 테스트될 때까지는 재개 흐름에서 미검증 상태로 남을 수 있습니다.

에이전트 설정

각 CLI 에이전트는 대시보드 기어 버튼을 통해 설정을 구성할 수 있습니다:

설정	설명
알림	상태 변경 알림 표시
자동 승인	지원되는 경우 도구 실행 자동 승인
승인 알림	승인이 필요할 때 알림
무진행 알림	턴이 너무 오래 진행이 없을 때 경고 (예전 명칭 "장기 생성 알림")
무진행 임계값	무진행 알림이 발동하기까지의 초 단위 임계값

자동 승인 모드 (1.0.60+)

위의 단순 온/오프 "자동 승인" 토글과 별개로, 모든 내장 CLI 프로바이더는 이제 자체적인 실행 시점 자동 승인 모드 집합을 선언합니다 — 세션을 시작할 때 표시되는 선택기이며, 기어 버튼 설정이 아닙니다. 각 모드는 실행 전에 무엇을 켜는지 알 수 있도록 위험 등급을 표시합니다:

위험	의미
안전	대화형 PTY 파싱 — ADHDev가 인식하는 프롬프트에 응답합니다. 도구 수준에서 우회되는 것은 없습니다
주의	프로바이더 자체의 "편집 수락" / "auto" 플래그가 실행 시 전달됩니다 — 더 넓은 자동 수락이지만 여전히 프로바이더 범위 내
위험	프로바이더의 전체 권한 우회 플래그(예: Claude Code의 --permission-mode bypassPermissions, kimi의 --auto) — 에이전트가 아무 프롬프트 없이 명령을 실행합니다. ADHDev는 이 모드로 실행하기 전 확인 대화상자를 표시합니다.

사용 가능한 모드는 프로바이더마다 다르며(해당 프로바이더 자체의 CLI 플래그에서 옴), 기본값은 항상 안전한 대화형 모드입니다.

모델 검색 (1.0.60+)

모델 선택기의 목록은 프로바이더에 따라 다르게 검색됩니다:

방법	프로바이더
실행 시 CLI 자체의 모델 목록 명령을 실행	codex-cli, grok-cli, cursor-cli, antigravity-cli, opencode
프로바이더의 로컬 설정 파일을 읽음	kimi
검색 불가능 — 매니페스트 목록을 그대로 사용	claude-cli

claude-cli의 모델 옵션(opus/sonnet/haiku/fable)은 버전이 붙는 슬러그가 아니라 안정적인 별칭이므로 검색된 목록처럼 변동하지 않습니다.

쿼터 리포팅

adhdev quota <provider>는 프로바이더의 현재 사용량 값을 출력합니다. adhdev quota refresh [providers...]는 실행 중인 데몬에게 실제로 값을 다시 가져와 캐시된 값(라우팅과 대시보드가 읽는 값)을 갱신하도록 요청하며, 활성 상태인 속도 제한 쿨다운을 존중합니다.

쿼터 리포팅은 claude-cli, codex-cli, kimi, opencode, grok-cli, cursor-cli, antigravity-cli(내장 CLI 7개 모두)에서 사용할 수 있습니다.

문제 해결

에이전트가 실행되지 않음

• 도구가 로컬에 설치되어 있는지 확인
• 머신의 Providers 탭에서 프로바이더를 활성화하고 Detect 실행
• 바이너리가 기본 PATH 밖에 있으면 커스텀 실행 파일 경로/인수 설정
• 업스트림 인증 또는 API 키 확인
• adhdev daemon:status로 로컬 상태 검사

터미널이 빈 화면

• 도구가 입력을 기다리고 있을 수 있음
• 대시보드에서 연결 상태 확인
• 중복 세션을 시작하기 전에 숨겨진 탭, 인박스, 히스토리 확인
• 런타임이 살아남았다면 즉시 재실행하는 대신 Hosted Runtimes를 통해 복구

터미널 출력이 잘못됨

• 업스트림 도구가 터미널을 잘못된 상태로 남겼다면 세션 재시작
• CLI 프로바이더의 정규 출력으로 터미널 뷰를 취급
• 문제가 지속되면 프로바이더 호환성 문제로 취급하고 먼저 호환성 페이지 확인

승인할 것이 없는데 승인 프롬프트가 표시됨 (1.0.60+)

일부 CLI는 터미널 자체 바깥의 단계에서 멈출 수 있습니다 — 가장 명확한 예는 grok-cli의 브라우저 기반 로그인입니다. ADHDev는 이제 이를 내부적으로 별도 상태로 추적하므로, 해당 세션은 조용히 유휴나 생성 중으로 보이는 대신 승인 인박스에 나타납니다(별도 배지가 아니라 일반적인 "사용자 대기" 항목으로 표시됩니다). 외부 단계(예: 브라우저 로그인 완료)를 마치면 세션이 정상적으로 재개됩니다.

다음 단계

• 시작하기 →
• MCP 서버 →
• 호환성 및 주의사항 →
• 문제 해결 →
• 프로바이더 문제 →
• 커스텀 프로바이더 →