Rode um agente de programação com IA em modo headless no CI
Instale o pacote oharness e rode oharness-headless "<task>": ele transmite um evento JSON por linha no stdout e sai com código 1 se a execução falhar. Ninguém pode responder a um pedido de permissão no CI, então tudo o que perguntaria é negado — autorize o trabalho antes com regras ou com --permission-mode.
Atualizado em
O comando
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"O prompt pode vir de um argumento ou do stdin (echo "task" | oharness-headless). -C <dir> define o diretório de trabalho, -r <id> continua uma sessão e --permission-mode aceita default, acceptEdits, plan, auto ou bypassPermissions.
O que sai
O stdout é JSONL e nada mais, então dá para encadear com jq; os diagnósticos vão para o stderr. O fluxo termina com um evento done que traz o motivo da parada, o uso, o custo e o 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}Permissões sem um humano
Uma execução que aprovasse tudo em silêncio seria mais perigosa sem supervisão do que com supervisão, então o modo headless faz o contrário: uma ferramenta que pediria permissão é negada e registrada como um evento permission_result. Permita o que o job precisa no .oharness/settings.json do projeto, onde isso pode ser revisado no repositório:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny vence todos os modos, inclusive o bypassPermissions. Perguntas que o agente faria a um usuário retornam na hora com a instrução de escolher um padrão sensato e dizer isso, e continuam aparecendo no fluxo como question_request e question_result.
Credenciais no CI
Use a variável de chave do provedor como secret do CI — DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY e assim por diante. No plano hospedado, uma chave criada no site vai em OHARNESS_API_KEY, e OHARNESS_TEAM cobra a execução de uma equipe. A verificação de atualizações é desligada automaticamente quando CI está definida.
Um passo no 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.jsonlPerguntas frequentes
Como rodar um agente de programação de forma não interativa?
Com o OHarness, rode oharness-headless "<task>". Ele imprime os eventos do agente como JSONL no stdout, grava os diagnósticos no stderr e sai com código 1 se a execução falhar.
O que acontece com os pedidos de permissão no modo headless?
Eles são negados e registrados como eventos permission_result, porque não há ninguém para responder. Permita as ferramentas de que o job precisa com regras de permissão em .oharness/settings.json, ou escolha um --permission-mode.
Quais modelos podem rodar em modo headless?
Qualquer modelo que o OHarness alcance: Anthropic, OpenAI, Gemini, DeepSeek, qualquer endpoint compatível com OpenAI ou um servidor local acessível pelo runner. Escolha com -m provider/model.