Faire tourner un agent de code IA en mode headless en CI

Installez le paquet oharness et lancez oharness-headless "<task>" : il diffuse un événement JSON par ligne sur stdout et se termine avec le code 1 si l'exécution a échoué. Personne ne peut répondre à une demande d'autorisation en CI : tout ce qui demanderait est donc refusé — autorisez le travail à l'avance avec des règles ou --permission-mode.

Mis à jour le

La commande

oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"

Le prompt peut venir d'un argument ou de stdin (echo "task" | oharness-headless). -C <dir> définit le répertoire de travail, -r <id> reprend une session, et --permission-mode vaut default, acceptEdits, plan, auto ou bypassPermissions.

Ce qui en sort

stdout ne contient que du JSONL, ce qui permet de le passer à jq ; les diagnostics vont sur stderr. Le flux se termine par un événement done qui indique la raison de l'arrêt, l'utilisation, le coût et le nombre de tours :

{"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}

Des permissions sans humain

Une exécution qui approuverait tout en silence serait plus dangereuse sans surveillance qu'avec ; le mode headless fait donc l'inverse : un outil qui demanderait une autorisation est refusé et signalé par un événement permission_result. Autorisez ce dont la tâche a besoin dans le fichier .oharness/settings.json du projet, où cela peut être relu dans le dépôt :

{
  "allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
  "deny":  ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}

deny l'emporte sur tous les modes, y compris bypassPermissions. Les questions que l'agent poserait à un utilisateur reviennent immédiatement avec la consigne de choisir une valeur par défaut raisonnable et de le signaler, et apparaissent quand même dans le flux sous forme de question_request et question_result.

Identifiants en CI

Utilisez la variable de clé du fournisseur comme secret CI — DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, etc. Avec l'offre hébergée, une clé créée sur le site va dans OHARNESS_API_KEY, et OHARNESS_TEAM facture l'exécution à une équipe. La vérification des mises à jour est automatiquement désactivée quand CI est défini.

Une étape 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

Questions fréquentes

Comment exécuter un agent de code de façon non interactive ?

Avec OHarness, lancez oharness-headless "<task>". Il affiche les événements de l'agent en JSONL sur stdout, écrit les diagnostics sur stderr et se termine avec le code 1 si l'exécution a échoué.

Que deviennent les demandes d'autorisation en mode headless ?

Elles sont refusées et signalées par des événements permission_result, puisque personne n'est là pour répondre. Autorisez les outils dont la tâche a besoin avec des règles de permission dans .oharness/settings.json, ou choisissez un --permission-mode.

Quels modèles peuvent tourner en mode headless ?

Tout modèle qu'OHarness peut joindre : Anthropic, OpenAI, Gemini, DeepSeek, n'importe quel endpoint compatible OpenAI, ou un serveur local accessible depuis le runner. Choisissez-le avec -m provider/model.

Voir aussi