CLI 에이전트

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

Aider, Gemini CLI, GitHub Copilot CLI, Goose 같은 에이전트는 내장 CLI 프로바이더가 아닙니다 — 대신 Agent Client Protocol(stdio)로 연결됩니다. 해당 에이전트는 ACP 에이전트 가이드를 참조하세요.

WARNING

내장이 검증된 지원을 의미하지 않습니다. 프로바이더가 호환성 문서에서 명시적으로 승격되지 않는 한 미검증으로 취급하세요.

내장 CLI 프로바이더

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

CLI가 중요한 이유

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

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

오늘 가장 신뢰할 수 있는 원격 워크플로를 원한다면 CLI 에이전트가 보통 첫 번째로 검증할 경로입니다. 현재 공개 승격 중에서 Claude Code, Codex CLI, Cursor CLI가 가장 명확한 증거를 가지고 있습니다.

CLI 에이전트 실행

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

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

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

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

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

WARNING

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

터미널 워크플로

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 에이전트는 대시보드 기어 버튼을 통해 설정을 구성할 수 있습니다:

설정	설명
알림	상태 변경 알림 표시
자동 승인	지원되는 경우 도구 실행 자동 승인
승인 알림	승인이 필요할 때 알림
장기 생성 알림	턴이 너무 오래 실행될 때 경고
장기 생성 임계값	초 단위 임계값 (30–600)

CLI vs ACP

기능	CLI 에이전트 (PTY)	ACP 에이전트 (stdio)
인터페이스	완전한 터미널 세션	구조화된 채팅 프로토콜
렌더링	xterm.js / 원시 터미널	마크다운 / 콘텐츠 블록
적합한 경우	실제 셸 워크플로, TUI 도구, 원격 감독	구조화된 이벤트가 있는 프로토콜 네이티브 에이전트
검증 모델	기본적으로 미검증. 프로바이더별 검증	기본적으로 미검증. 프로바이더별 검증

문제 해결

에이전트가 실행되지 않음

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

터미널이 빈 화면

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

터미널 출력이 잘못됨

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

다음 단계

• 시작하기 →
• ACP 에이전트 →
• MCP 서버 →
• 호환성 및 주의사항 →
• 문제 해결 →
• 프로바이더 문제 →