Agente de codificação CLI

O adk-rust CLI inclui três comandos nativos de codificação. Todos executam um agente real em um espaço de trabalho 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, …) — portanto, nunca ficam bloqueados aguardando um prompt de configuração.

code — tarefa de execução única

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 ferramentas, resultados, texto), além do plano final.

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

O padrão /goal do Codex/Hermes: forneça um objetivo e uma condição de sucesso verificável (--until é um comando de shell que deve terminar com o código 0). O agente repete o ciclo planejar → agir → verificar, corrigindo-se com base na saída da verificação, até que ela seja aprovada ou o limite de iterações seja atingido.

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 usando --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 do ponto em que foi interrompida.

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 ultraparalela

O padrão de ultracode/ultrareview do Claude Code: implemente a tarefa e, em seguida, distribua-a entre revisores especialistas em paralelo (correção, casos extremos, estilo), sintetize os pareceres e faça revisões até que eles 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 opções globais --model / --provider / --api-key. O padrão é gemini-3.1-flash-lite (uso rápido e confiável de ferramentas em várias etapas). Para OpenAI: --provider openai --model gpt-5.6-terra (com OPENAI_API_KEY).

Próximo: Fluxos de trabalho →