Coding Agent CLI

adk-rust CLI에는 세 가지 네이티브 코딩 명령이 포함되어 있습니다. 모두 격리된 작업 공간에서 실제 에이전트를 실행하며, 기본적으로 Gemini 3 모델을 사용하고, --api-key 또는 환경 변수(GEMINI_API_KEY/GOOGLE_API_KEY, OPENAI_API_KEY, …)에서 API 키를 대화형 입력 없이 확인하므로 설정 프롬프트에서 멈추지 않습니다.

code — 일회성 작업

adk-rust code "make the failing test pass"
adk-rust code --dir ./project "add a /health route"
adk-rust code --read-only "explain how auth works"   # no writes / no shell

에이전트는 작업을 탐색하고, 편집하고, 명령을 실행하며, 작업 과정(도구 호출, 결과, 텍스트)과 최종 계획을 스트리밍합니다.

goal — 자율 목표 모드(지속 가능, 재개 가능)

Codex/Hermes /goal 패턴입니다. 목표와 검증 가능한 성공 조건을 지정합니다(--until는 종료 코드 0을 반환해야 하는 셸 명령입니다). 에이전트는 검사가 통과하거나 반복 횟수 예산에 도달할 때까지 계획 → 실행 → 검증을 반복하며, 검사 출력에 따라 스스로 수정합니다.

adk-rust goal "make all tests pass" --until "cargo test" --max-iters 8
adk-rust goal "port utils.py to type hints" --until "mypy utils.py" --dir ./svc

지속 가능 및 재개 가능. 각 반복이 끝날 때마다 목표 상태가 <dir>/.adk/goal.json에 원자적으로 체크포인트 저장됩니다(--state <path>로 재정의 가능). 실행이 중단된 경우 다음과 같이 계속할 수 있습니다.

adk-rust goal "…" --until "cargo test" --resume

--resume는 완료된 목표를 아무 작업도 필요 없는 상태로 인식하며, 진행 중인 running 또는 예산이 exhausted인 실행을 중단된 지점부터 계속합니다.

성공 조건은 목표 모드를 안전하고 효과적으로 만드는 요소입니다. 에이전트가 "완료"를 명확하게 기계적으로 검사할 수 있도록, 검증 가능한 항목(테스트 모음, 타입 검사기, 빌드 등)을 선택하세요.

ultracode — 병렬 초정밀 검토

Claude Code의 ultracode/ultrareview 패턴: 작업을 구현한 다음 병렬 전문 검토자(정확성, 엣지 케이스, 스타일)에게 분산 검토를 요청하고, 그들의 판정을 종합한 후, 승인을 받을 때까지 수정하는 방식이며 adk-graph를 기반으로 합니다.

adk-rust ultracode "add input validation to the parser"
adk-rust ultracode --dir ./project --max-rounds 3 "implement a retry wrapper"

각 검토자의 판정, 라운드별 종합 결정, 그리고 finalize로 끝나는 수정 단계를 확인할 수 있습니다.

모델 선택

세 명령 모두 전역 --model / --provider / --api-key 플래그를 허용합니다. 기본값은 gemini-3.1-flash-lite입니다(빠르고 안정적인 다단계 도구 사용). OpenAI의 경우: --provider openai --model gpt-5.6-terra(OPENAI_API_KEY 포함).

다음: 워크플로 →