ay errors
Dokumentation der CLI-Exit-Codes — direkt im Terminal ablesbar. Hilfreich für Shell-Scripts, CI-Logs und AI-Agenten, die Non-Zero-Exit interpretieren müssen.
Subcommands
ay errors / ay errors list
Listet alle dokumentierten Exit-Codes.
ay errors
ay errors list
ay errors explain <code>
Detail-View mit Bedeutung und Recovery-Hinweis.
ay errors explain 2
ay errors explain 4
Exit-Code-Tabelle
| Code | Name | Bedeutung |
|---|---|---|
0 |
EXIT_SUCCESS | Befehl erfolgreich |
1 |
EXIT_GENERAL_ERROR | Allgemeiner Fehler — --debug für Details |
2 |
EXIT_MISUSE | Ungültige Verwendung — ay <cmd> --help |
4 |
EXIT_AUTH_REQUIRED | Token fehlt/abgelaufen — ay login |
5 |
EXIT_PERMISSION_DENIED | Recht fehlt — Admin fragen, access prüfen |
78 |
EXIT_CONFIG_ERROR | Config invalid — ~/.config/ayoune/config.json prüfen, doctor |
Beispiele
# In CI-Pipeline
if ay export run consumers --format csv; then
echo "Export ok"
elif [ $? -eq 5 ]; then
echo "Permission denied — check rights"
elif [ $? -eq 4 ]; then
ay login
fi
# Erklärung in der Shell
ay errors explain 5