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.jsonl

Perguntas 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.

Relacionados