Einen KI-Coding-Agent headless in CI ausführen
Installieren Sie das Paket oharness und führen Sie oharness-headless "<task>" aus: Es streamt ein JSON-Ereignis pro Zeile nach stdout und beendet sich mit 1, wenn der Lauf fehlgeschlagen ist. In CI kann niemand eine Rückfrage beantworten, also wird alles abgelehnt, was nachfragen würde – erlauben Sie die Arbeit vorab mit Regeln oder --permission-mode.
Aktualisiert am
Der Befehl
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"Der Prompt kann als Argument oder über stdin kommen (echo "task" | oharness-headless). -C <dir> setzt das Arbeitsverzeichnis, -r <id> setzt eine Sitzung fort, und --permission-mode ist einer von default, acceptEdits, plan, auto oder bypassPermissions.
Was herauskommt
stdout enthält ausschließlich JSONL und lässt sich deshalb direkt an jq weiterleiten; Diagnosen gehen nach stderr. Der Stream endet mit einem done-Ereignis, das Stoppgrund, Nutzung, Kosten und Anzahl der Durchgänge enthält:
{"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}Berechtigungen ohne Mensch
Ein Lauf, der stillschweigend alles freigibt, wäre unbeaufsichtigt gefährlicher als beaufsichtigt – deshalb macht der Headless-Modus das Gegenteil: Ein Tool, das nachfragen würde, wird abgelehnt und als permission_result-Ereignis gemeldet. Erlauben Sie, was der Job braucht, in der Projektdatei .oharness/settings.json, wo es im Repository überprüfbar ist:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny gewinnt gegen jeden Modus, auch gegen bypassPermissions. Fragen, die der Agent einem Nutzer stellen würde, kehren sofort mit der Anweisung zurück, einen sinnvollen Standard zu wählen und das zu sagen; sie erscheinen trotzdem im Stream als question_request und question_result.
Zugangsdaten in CI
Hinterlegen Sie die Schlüsselvariable des Anbieters als CI-Secret – DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY und so weiter. Im gehosteten Tarif kommt ein auf der Website erstellter Schlüssel in OHARNESS_API_KEY, und OHARNESS_TEAM rechnet den Lauf über ein Team ab. Die Update-Prüfung ist automatisch aus, wenn CI gesetzt ist.
Ein Schritt 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.jsonlHäufige Fragen
Wie führe ich einen Coding-Agent nicht interaktiv aus?
Mit OHarness führen Sie oharness-headless "<task>" aus. Es gibt die Ereignisse des Agenten als JSONL auf stdout aus, schreibt Diagnosen nach stderr und beendet sich mit Code 1, wenn der Lauf fehlgeschlagen ist.
Was passiert im Headless-Modus mit Rückfragen?
Sie werden abgelehnt und als permission_result-Ereignisse gemeldet, weil niemand da ist, der antworten könnte. Erlauben Sie die Tools, die der Job braucht, mit Berechtigungsregeln in .oharness/settings.json, oder wählen Sie einen --permission-mode.
Welche Modelle können headless laufen?
Jedes Modell, das OHarness erreicht: Anthropic, OpenAI, Gemini, DeepSeek, jeder OpenAI-kompatible Endpunkt oder ein lokaler Server, den der Runner erreichen kann. Wählen Sie es mit -m provider/model.