Axe: Ein 12-MB-CLI für Single-Purpose-LLM-Agenten

Was Axe ist

Axe ist eine 12 MB große Go-Binärdatei mit zwei Abhängigkeiten (cobra, toml), die KI-Frameworks durch einen Unix-inspirierten Ansatz für LLM-Agenten ersetzt. Anstatt lang laufender Chatbot-Sitzungen führt es zielgerichtete Agenten aus, die in TOML-Konfigurationsdateien definiert sind. Jeder Agent hat eine spezifische Aufgabe wie Code-Review, Log-Analyse oder das Schreiben von Commit-Nachrichten.

Kernfunktionen

• TOML-basierte Konfiguration: Deklarative, versionskontrollierbare Agentendefinitionen mit System-Prompts, Modellauswahl, Skill-Dateien und Kontextdateien
• Stdin-Piping: git diff | axe run reviewer funktioniert direkt
• Sub-Agenten-Delegation: Agenten können andere Agenten über LLM-Toolnutzung aufrufen, mit Tiefenbegrenzung und paralleler Ausführung
• Persistenter Speicher: Zeitgestempelte Markdown-Logs tragen Kontext über mehrere Ausführungen hinweg, mit LLM-unterstützter Garbage Collection
• Multi-Provider-Unterstützung: Funktioniert mit Anthropic, OpenAI, Ollama (lokale Modelle) oder jedem models.dev-Format
• Integrierte Tools: Websuche, URL-Abruf und pfadgeschützte Dateioperationen (lesen, schreiben, bearbeiten, auflisten), die auf das Arbeitsverzeichnis des Agenten beschränkt sind
• MCP-Unterstützung: Kann jeden MCP-Server mit Agenten verbinden
• Skill-System: Wiederverwendbare Anweisungssätze, die von Agenten gemeinsam genutzt werden
• JSON-Ausgabe: Strukturierte Ausgabe mit Metadaten für Skripting
• Dry-Run-Modus: Überprüfen des aufgelösten Kontexts ohne LLM-Aufruf

Installation & Einrichtung

Erfordert Go 1.24+. Installation über:

go install github.com/jrswab/axe@latest

Oder aus dem Quellcode bauen:

git clone https://github.com/jrswab/axe.git
cd axe
go build .

Konfiguration initialisieren:

axe config init

Erstellt eine Verzeichnisstruktur unter $XDG_CONFIG_HOME/axe/ mit Beispiel-Skills und einer Standard-config.toml für Provider-Anmeldedaten.

Anwendungsbeispiele

Einen Agenten erstellen und ausführen:

axe agents init my-agent
axe agents edit my-agent
axe run my-agent

Daten von anderen Tools pipen:

git diff --cached | axe run pr-reviewer
cat error.log | axe run log-analyzer

Beispiel-Agenten aus dem examples/-Verzeichnis kopieren:

cp examples/code-reviewer/code-reviewer.toml "$(axe config path)/agents/"
cp -r examples/code-reviewer/skills/ "$(axe config path)/skills/"
export ANTHROPIC_API_KEY="your-key-here"
git diff | axe run code-reviewer

Docker-Bereitstellung

Image bauen:

docker build -t axe .

Multi-Architektur-Builds (linux/amd64, linux/arm64) über buildx:

docker buildx build --platform linux/amd64,linux/arm64 -t axe:latest .

Einen Agenten mit eingebundener Konfiguration ausführen:

docker run --rm \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe run my-agent

Stdin mit -i-Flag pipen:

git diff | docker run --rm -i \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe run my-agent

Für wen es gedacht ist

Entwickler, die spezifische KI-Aufgaben ohne Framework-Overhead automatisieren möchten, insbesondere solche, die bereits Unix-Tools, Git-Hooks, Cron oder CI-Pipelines verwenden.