Ejecutar un agente de código IA en modo headless en CI
Instala el paquete oharness y ejecuta oharness-headless "<task>": emite un evento JSON por línea en stdout y sale con 1 si la ejecución falla. En CI nadie puede responder a una solicitud de permiso, así que todo lo que preguntaría se deniega; autoriza el trabajo de antemano con reglas o con --permission-mode.
Actualizado el
El comando
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"El prompt puede venir de un argumento o de stdin (echo "task" | oharness-headless). -C <dir> fija el directorio de trabajo, -r <id> continúa una sesión y --permission-mode es uno de default, acceptEdits, plan, auto o bypassPermissions.
Qué sale
stdout es JSONL y nada más, así que se puede pasar a jq; los diagnósticos van a stderr. El flujo termina con un evento done que incluye el motivo de parada, el uso, el coste y el número de turnos:
{"type":"session","id":"20260808_...","model":"deepseek-v4-flash","cwd":"/repo"}
{"type":"tool_start","toolCallId":"c1","toolName":"grep","title":"grep(build)","input":{...}}
{"type":"text_delta","text":"The build entry point is "}
{"type":"done","stopReason":"end_turn","usage":{...},"costUsd":0.004,"turns":2}Permisos sin una persona delante
Una ejecución que lo aprobara todo en silencio sería más peligrosa sin supervisión que con ella, así que el modo headless hace lo contrario: una herramienta que pediría confirmación se deniega y se notifica como un evento permission_result. Permite lo que necesita el trabajo en el .oharness/settings.json del proyecto, donde se puede revisar en el repositorio:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny gana a cualquier modo, incluido bypassPermissions. Las preguntas que el agente haría a un usuario vuelven de inmediato con la instrucción de elegir un valor razonable por defecto y decirlo, y siguen apareciendo en el flujo como question_request y question_result.
Credenciales en CI
Usa la variable de clave del proveedor como secreto de CI: DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, etc. Con el plan alojado, una clave creada en el sitio va en OHARNESS_API_KEY, y OHARNESS_TEAM factura la ejecución a un equipo. La comprobación de actualizaciones se desactiva automáticamente cuando CI está definida.
Un paso de GitHub Actions
- run: npm install -g oharness
- run: oharness-headless --permission-mode acceptEdits "run npm test and fix failures" > run.jsonl
env:
DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
- run: jq -r 'select(.type=="done") | .stopReason' run.jsonlPreguntas frecuentes
¿Cómo ejecuto un agente de código de forma no interactiva?
Con OHarness, ejecuta oharness-headless "<task>". Imprime los eventos del agente como JSONL en stdout, escribe los diagnósticos en stderr y sale con código 1 si la ejecución falla.
¿Qué pasa con las solicitudes de permiso en modo headless?
Se deniegan y se notifican como eventos permission_result, porque no hay nadie para responder. Permite las herramientas que necesita el trabajo con reglas de permisos en .oharness/settings.json, o elige un --permission-mode.
¿Qué modelos pueden ejecutarse en modo headless?
Cualquier modelo al que llegue OHarness: Anthropic, OpenAI, Gemini, DeepSeek, cualquier endpoint compatible con OpenAI o un servidor local accesible desde el runner. Elígelo con -m provider/model.