Een AI-coding-agent headless draaien in CI
Installeer het pakket oharness en draai oharness-headless "<task>": het streamt één JSON-event per regel naar stdout en eindigt met exitcode 1 als de run mislukt is. In CI kan niemand een toestemmingsvraag beantwoorden, dus alles wat zou vragen wordt geweigerd — geef het werk vooraf toestemming met regels of --permission-mode.
Bijgewerkt op
Het commando
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"De prompt kan uit een argument komen of uit stdin (echo "task" | oharness-headless). -C <dir> stelt de werkmap in, -r <id> zet een sessie voort, en --permission-mode is een van default, acceptEdits, plan, auto of bypassPermissions.
Wat eruit komt
stdout bevat JSONL en verder niets, dus je kunt het naar jq pipen; diagnostiek gaat naar stderr. De stream eindigt met een done-event met de stopreden, het gebruik, de kosten en het aantal beurten:
{"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}Permissies zonder mens
Een run die stilzwijgend alles goedkeurt, zou zonder toezicht gevaarlijker zijn dan met toezicht, dus headless doet het omgekeerde: een tool die om toestemming zou vragen, wordt geweigerd en gemeld als permission_result-event. Sta toe wat de job nodig heeft in de .oharness/settings.json van het project, waar het in de repository te reviewen is:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny wint van elke modus, ook van bypassPermissions. Vragen die de agent aan een gebruiker zou stellen, komen meteen terug met de instructie een verstandige standaardkeuze te maken en dat te melden, en verschijnen nog steeds in de stream als question_request en question_result.
Inloggegevens in CI
Gebruik de sleutelvariabele van de aanbieder als CI-secret — DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY enzovoort. Met het gehoste abonnement zet je een sleutel die je op de site hebt aangemaakt in OHARNESS_API_KEY, en met OHARNESS_TEAM wordt de run aan een team gefactureerd. De updatecontrole staat automatisch uit als CI is ingesteld.
Een stap in 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.jsonlVeelgestelde vragen
Hoe draai ik een AI-coding-agent niet-interactief?
Met OHarness draai je oharness-headless "<task>". Het geeft de events van de agent als JSONL op stdout, schrijft diagnostiek naar stderr en eindigt met exitcode 1 als de run mislukt is.
Wat gebeurt er met toestemmingsvragen in headless modus?
Die worden geweigerd en gemeld als permission_result-events, omdat er niemand is om te antwoorden. Sta de tools die de job nodig heeft toe met permissieregels in .oharness/settings.json, of kies een --permission-mode.
Welke modellen kunnen headless draaien?
Elk model dat OHarness kan bereiken: Anthropic, OpenAI, Gemini, DeepSeek, elk OpenAI-compatibel endpoint, of een lokale server die vanaf de runner bereikbaar is. Kies het met -m provider/model.