Was macht axi?
Agent eXperience Interface (AXI) — ergonomische Standards für die Entwicklung von CLI-Tools, die von Agenten über Shell-Ausführung genutzt werden. Verwenden Sie dies beim Erstellen, Ändern oder Überprüfen von agentenorientierten CLIs.
Übersicht
Die AXI-Standards definieren eine Reihe von Konventionen, die sicherstellen, dass CLI-Tools von KI-Agenten konsistent interpretiert und zuverlässig verwendet werden können. Dies umfasst:
- Einheitliche Ausgabeformate (z.B. tabellarische Ausgaben mit Headern, JSON-Ausgaben)
- Klare und konsistente Exit-Codes
- Robuste Fehlerbehandlung mit aussagekräftigen Fehlermeldungen
- Minimale Abhängigkeiten und kurze Startzeiten
- Standardisierte Befehlsstrukturen (Subcommands, Flags, Argumente)
Kernprinzipien
- Konsistenz: Verwenden Sie durchgängig dieselben Muster für ähnliche Operationen.
- Vorhersagbarkeit: Ausgaben sollten ohne Kontextwechsel interpretierbar sein.
- Fehlertoleranz: Fehler sollten klar gemeldet werden, ohne den Workflow des Agenten zu blockieren.
- Effizienz: Befehle sollten schnell ausgeführt werden und keine unnötigen Ressourcen verbrauchen.
Formatierungsrichtlinien
- Tabellarische Ausgabe: Immer mit Header-Zeile, Spalten durch Leerzeichen getrennt.
- JSON-Ausgabe: Verwenden Sie
--jsonoder-jfür maschinenlesbare Ausgabe. - Fehlerausgabe: Auf stderr ausgeben, Exit-Code 0 für Erfolg, 1 für allgemeine Fehler, 2 für Syntaxfehler.
Beispiel
# Tabellarische Ausgabe
$ axi list
NAME STATUS AGE
my-app running 3d
# JSON-Ausgabe
$ axi list --json
{"items": [{"name": "my-app", "status": "running", "age": "3d"}]}
Integration mit Agentenplatformen
Diese Standards sind plattformunabhängig und funktionieren mit Claude Code, Cursor, Codex und anderen Agenten, die Shell-Befehle ausführen können. Die Einhaltung der AXI-Standards ermöglicht eine nahtlose Integration ohne zusätzliche Anpassungen.
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert.