Codes de sortie
Valeurs renvoyées par la CLI en succès ou échec.
Codes de sortie
AgentFlow suit les usages Go/Cobra : scripts et pipelines peuvent bifurquer sur $? sans adaptations.
| Code | Signification |
|---|---|
| 0 | Commande terminée sans erreur |
| 1 | Erreur générale (RunE a renvoyé une erreur — config, git, workflow, budget, agent) |
| 2 | Erreur d’usage Cobra (flag inconnu, arité incorrecte) — typiques des lignes incorrectes |
Exemples
Les extraits montrent la différence entre soucis de syntaxe (sortie 2), bonnes voies (0 lorsque tout passe pendant doctor ou une estimation seule qui réussit), et problèmes d’exploration budgétaire ou validations qui montent comme 1 avec message sur stderr.
agentflow work # exit 2 — argument instruction manquant
agentflow doctor # exit 0 quand tous contrôles passent
agentflow work "x" --estimate-only # exit 0 quand l’estimation fonctionneLes blocages budgétaires et validations échouées remontent en exit 1 avec stderr.
Scripts
Combiner avec || dans vos scripts et rappeler --dry-run si vous vérifiez seulement le câblage CI sans faire échouer l’étape lorsqu’un agent n’est pas installé.
agentflow verify my-feature || echo "verify failed"--dry-run en CI diminue codes non-zero dus uniquement aux binaires agent absents alors que vous ne testez que l’écorchage.