Hax: Ein minimalistischer Terminal-nativer Codierungs-Agent in C

Hax ist ein minimalistischer, terminalbasierter Codierungsagent, der in C geschrieben ist. Er wird als einzelnes natives Binary mit minimalen Abhängigkeiten ausgeliefert, startet sofort und verbraucht nur wenige MB RAM – so bleibt mehr Speicher für Ihre lokalen LLMs.

Hauptfunktionen

• Leichtgewichtiges Design: Ein einzelnes natives C-Binary mit einem kleinen Abhängigkeitssatz. Startet sofort und verbraucht nur sehr wenig Speicher (nur ein paar MB) – so bleibt mehr RAM für Ihre lokalen LLMs.
• Lokale Modelle sind erstklassig: Hax erkennt automatisch das Modell und die Laufzeitfähigkeiten. Kein benutzerdefinierter Provider-Konfigurationsblock für das Standard-Setup erforderlich. Beispiel:

llama-server -m [model].gguf
hax --provider llama.cpp

• Respektiert Ihr Terminal: Streaming-Markdown und Live-Tool-Ausgaben werden für die Anzeige neu umgebrochen. Es wird nur die aktuelle Streaming-Zeile oder der Eingabebereich neu gezeichnet, wobei der native Scrollback erhalten bleibt. Es übernimmt oder manipuliert Ihr Terminal nicht.
• Überprüfbar: Sehen Sie genau, was an das Modell gesendet wurde und was es in einer nutzbaren Transkriptansicht (Strg+T) geantwortet hat. Optional kann eine detaillierte Drahtprotokollablaufverfolgung gesammelt werden.
• Beliebige Provider/Modelle verwenden: Unterstützt OpenAI (+kompatibel), Anthropic (+kompatibel), Codex (über ChatGPT-Abonnement), OpenRouter, llama.cpp usw.
• Wohlverhaltenes Unix-Tool: XDG-Pfade, saubere Standardausgabe im -p-Einzelmodus mit Fortsetzungshinweisen auf stderr, Klartext-Konfigurations- und Sitzungsdateien, Zusammensetzung über Subprozesse statt Plugins.

Für wen es gedacht ist

Entwickler, die im Terminal leben, lokale Modelle ausführen, prüfen, was ihre Tools tun, Software für Distributionen paketieren oder Agenten betreiben, bei denen Ressourcen knapp sind. Wenn Sie MCP-Marktplätze, eine Plugin-Laufzeitumgebung, IDE-Panels oder Berechtigungsabfragen pro Befehl wünschen, bauen andere Agenten genau das – hax tut dies bewusst nicht, und docs/philosophy.md erklärt jede Auslassung.

Erste Schritte

Hax läuft unter Linux und macOS; unter Windows verwenden Sie es unter WSL. Installation mit Homebrew:

brew install oleksandrchekhovskyi/hax/hax

Unter Arch Linux ist hax im AUR als hax verfügbar. Unter jedem Linux laden Sie das vorgefertigte statische Binary (x86_64 oder aarch64) aus dem neuesten Release herunter und legen Sie es in Ihren PATH.

Aus dem Quellcode erstellen:

git clone https://github.com/OleksandrChekhovskyi/hax.git
cd hax
scripts/install_deps.sh  # Debian/Ubuntu, Fedora, Arch, openSUSE, Alpine, macOS
make                     # Binary unter ./build/hax
make install             # optional; kann nach sudo fragen

Führen Sie hax aus dem Projektverzeichnis aus, in dem Sie arbeiten möchten:

hax                # interaktive REPL
hax -p "TODOs auflisten"  # einen Prompt ausführen und die endgültige Antwort ausgeben
printf "x erklären" | hax -p   # Prompt von stdin lesen
hax -c             # die neueste Sitzung für dieses Verzeichnis fortsetzen
hax --resume       # eine vergangene Sitzung für dieses Verzeichnis auswählen
hax --resume=ID -p "weiter"   # eine bestimmte Sitzung im Einzelmodus fortsetzen

Der einfachste erste Start ist interaktiv: Starten Sie hax und verwenden Sie dann /provider, um verfügbare Provider zu sehen und ein Modell auszuwählen. Hax merkt sich interaktive Provider-, Modell- und Aufwand-Auswahl. Weitere Informationen zur Provider-Einrichtung und vollständige Dokumentation finden Sie in der README.