Coding Agent CLI

O adk-rust CLI traz três comandos nativos de codificação. Todos executam um agente real em um workspace confinado, usam por padrão um modelo Gemini 3 e resolvem a chave API de forma não interativa a partir de --api-key ou do ambiente (GEMINI_API_KEY/GOOGLE_API_KEY, OPENAI_API_KEY, …) — então nunca ficam aguardando um prompt de configuração.

code — tarefa de uma única execução

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

O agente explora, edita, executa comandos e transmite seu trabalho (chamadas de ferramenta, resultados, texto) além do plano final.

goal — modo de objetivo autônomo (durável, retomável)

O padrão Codex/Hermes /goal: forneça um objetivo e uma condição de sucesso verificável (--until é um comando de shell que deve sair com 0). O agente entra em loop planejar → agir → verificar, corrigindo-se a partir da saída da verificação, até que passe ou o limite de iterações seja alcançado.

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

Durável e retomável. Após cada iteração, o estado do objetivo é salvo atomicamente em <dir>/.adk/goal.json (substitua com --state <path>). Se uma execução for interrompida, continue-a:

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

--resume reconhece um objetivo concluído como uma operação sem efeito e continua uma execução running ou com orçamento exhausted a partir de onde parou.

A condição de sucesso é o que torna o modo de objetivo seguro e eficaz — escolha algo verificável (uma suíte de testes, um verificador de tipos, uma compilação) para que o agente tenha uma definição clara e verificável por máquina de "concluído".

ultracode — revisão ultra-paralela

O padrão Claude Code ultracode/ultrareview: implemente a tarefa e, em seguida, distribua para revisores especialistas em paralelo (correção, casos extremos, estilo), sintetize seus veredictos e revise até que aprovem — baseado em adk-graph.

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

Você verá o veredito de cada revisor, a decisão sintetizada por rodada e as etapas de revisão, terminando em finalize.

Escolhendo um modelo

Todos os três comandos aceitam as flags globais --model / --provider / --api-key. O padrão é gemini-3.1-flash-lite (uso de ferramentas em várias etapas, rápido e confiável). Para OpenAI: --provider openai --model gpt-5-mini (com OPENAI_API_KEY).

Próximo: Workflows →