Kör en AI-kodagent headless i CI
Installera paketet oharness och kör oharness-headless "<task>": den strömmar en JSON-händelse per rad till stdout och avslutar med 1 om körningen misslyckades. Ingen kan svara på en behörighetsfråga i CI, så allt som skulle fråga nekas — förhandsgodkänn arbetet med regler eller --permission-mode.
Uppdaterad
Kommandot
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"Prompten kan komma från ett argument eller från stdin (echo "task" | oharness-headless). -C <dir> sätter arbetskatalogen, -r <id> fortsätter en session, och --permission-mode är ett av default, acceptEdits, plan, auto eller bypassPermissions.
Vad som kommer ut
stdout är JSONL och inget annat, så det går att skicka vidare till jq; diagnostik går till stderr. Strömmen slutar med en done-händelse som innehåller stoppskälet, användningen, kostnaden och antalet turer:
{"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}Behörigheter utan en människa
En körning som i tysthet godkände allt vore farligare obevakad än bevakad, så headless-läget gör tvärtom: ett verktyg som skulle fråga nekas och rapporteras som en permission_result-händelse. Tillåt det jobbet behöver i projektets .oharness/settings.json, där det kan granskas i repositoryt:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny vinner över alla lägen, även bypassPermissions. Frågor som agenten skulle ställa till en användare returneras direkt med en instruktion att välja ett rimligt standardval och säga det, och syns ändå i strömmen som question_request och question_result.
Inloggningsuppgifter i CI
Använd leverantörens nyckelvariabel som en CI-hemlighet — DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY och så vidare. På den hostade planen läggs en nyckel som skapats på webbplatsen i OHARNESS_API_KEY, och OHARNESS_TEAM debiterar körningen till ett team. Uppdateringskontrollen stängs av automatiskt när CI är satt.
Ett steg i 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.jsonlVanliga frågor
Hur kör jag en kodagent icke-interaktivt?
Med OHarness kör du oharness-headless "<task>". Den skriver ut agentens händelser som JSONL på stdout, skriver diagnostik till stderr och avslutar med kod 1 om körningen misslyckades.
Vad händer med behörighetsfrågor i headless-läge?
De nekas och rapporteras som permission_result-händelser, eftersom ingen finns där för att svara. Tillåt verktygen som jobbet behöver med behörighetsregler i .oharness/settings.json, eller välj ett --permission-mode.
Vilka modeller kan köras headless?
Alla modeller som OHarness kan nå: Anthropic, OpenAI, Gemini, DeepSeek, valfri OpenAI-kompatibel endpoint eller en lokal server som nås från runnern. Välj den med -m provider/model.