Agente de programación CLI
El adk-rust CLI incluye tres comandos nativos de programación. Todos ejecutan un agente real en un espacio de trabajo aislado, utilizan de forma predeterminada un modelo Gemini 3 y resuelven la clave API de forma no interactiva desde --api-key o el entorno
(GEMINI_API_KEY/GOOGLE_API_KEY, OPENAI_API_KEY, …), por lo que nunca se bloquean esperando una solicitud de configuración.
code — tarea de una sola ejecución
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
El agente explora, edita, ejecuta comandos y transmite su trabajo (llamadas a herramientas, resultados, texto), además del plan final.
goal — modo de objetivo autónomo (persistente y reanudable)
El patrón de /goal de Codex/Hermes: proporciona un objetivo y una condición de éxito verificable (--until es un comando de shell que debe finalizar con el código 0). El agente repite el ciclo planificar → actuar → verificar, corrigiéndose a sí mismo a partir de la salida de la comprobación, hasta que esta se supera o se alcanza el presupuesto de iteraciones.
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
Persistente y reanudable. Después de cada iteración, el estado del objetivo se guarda atómicamente en <dir>/.adk/goal.json (se puede anular con --state <path>). Si una ejecución se interrumpe, continúala:
adk-rust goal "…" --until "cargo test" --resume
--resume reconoce un objetivo completado como una operación sin efecto y continúa una ejecución running o una ejecución con presupuesto exhausted desde el punto en el que se detuvo.
| Indicador | Significado |
|---|---|
--until <cmd> | Condición de éxito: salir con 0 = objetivo cumplido (obligatorio). |
--dir <path> | Directorio del espacio de trabajo (predeterminado: .). |
--max-iters <n> | Presupuesto de iteraciones (predeterminado: 8). |
--state <path> | Archivo de punto de control (predeterminado: <dir>/.adk/goal.json). |
--resume | Reanudar desde el punto de control guardado. |
La condición de éxito es lo que hace que el modo de objetivos sea seguro y eficaz: elige algo verificable (un conjunto de pruebas, un comprobador de tipos, una compilación) para que el agente tenga una definición clara y comprobable por máquina de «hecho».
ultracode — revisión ultra paralela
El patrón de Claude Code ultracode/ultrareview: implementa la tarea y, después, distribúyela entre revisores especialistas en paralelo (corrección, casos límite y estilo), sintetiza sus veredictos y revisa hasta que la aprueben, basado en
adk-graph.
adk-rust ultracode "add input validation to the parser"
adk-rust ultracode --dir ./project --max-rounds 3 "implement a retry wrapper"
| Indicador | Significado |
|---|---|
--dir <path> | Directorio del espacio de trabajo (por defecto, .). |
--max-rounds <n> | Número máximo de rondas de revisión → modificación (por defecto, 2). |
Verás el veredicto de cada revisor, la decisión sintetizada de cada ronda y los pasos de revisión, que terminan en finalize.
Elegir un modelo
Los tres comandos aceptan las opciones globales --model / --provider / --api-key. El valor predeterminado es gemini-3.1-flash-lite (uso rápido y fiable de herramientas en varios pasos). Para OpenAI: --provider openai --model gpt-5.6-terra (con OPENAI_API_KEY).
Siguiente: Flujos de trabajo →