Grok Build en modo headless para scripts y CI
Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026
grok -p (un turno) imprime la respuesta y sale, ideal en scripts y CI. Los subcomandos agent exponen stdio y otros modos para editores y harnesses.
Grok Build es la CLI de código de xAI (grok), no el chatbot Grok.Headless de un turno
export XAI_API_KEY="xai-..."
grok -p "Lista los tres riesgos top del repo"
grok -p "Resume el git diff" --output-format jsonLos formatos de salida son plain (por defecto), json y streaming-json; la salida JSON incluye un sessionId que puedes pasar a -r en un paso siguiente. En CI, usa --permission-mode dontAsk con reglas --allow explícitas para que lo no permitido se deniegue en vez de quedarse esperando, limita la ejecución con --max-turns y añade --no-auto-update para saltarte la comprobación de actualizaciones. La documentación headless lista todos los flags.
Nunca dejes API keys de producción en logs públicos. Usa secrets de CI y sandboxes con el mínimo privilegio (--sandbox cuando encaje).
Modo agent
grok agent expone runtimes sin TUI (stdio, websocket headless, serve, leader) que hablan Agent Client Protocol (ACP). grok agent stdio es el que usan la mayoría de editores y SDKs. Úsalo al embeber Grok en un bridge de IDE o en un montaje con varios clientes. Ver grok agent --help.
Headless vs CodeAgentSwarm
Headless es para máquinas. CodeAgentSwarm es para humanos que supervisan CLIs interactivas. Se complementan.
Preguntas frecuentes
¿Cómo corro Grok Build en CI?
Define XAI_API_KEY y usa grok -p con --permission-mode dontAsk y reglas --allow para los comandos que necesita el job. Añade --no-auto-update y usa salida json si un script tiene que leer el resultado.
¿-p es lo mismo que agent?
No. -p es un helper de un turno. grok agent es para integraciones más largas.