Die hansa Kommandozeile
hansa ist ein zustandsloser Kommandozeilen-Client für Ihren HansaChat
Workspace. Er ist für Skripte, Automatisierung und KI-Agenten gebaut: Jeder
Befehl gibt standardmäßig zuverlässiges JSON aus, und Befehle führen zu dem
Zustand, den Sie anfordern — derselbe Befehl zweimal ausgeführt dupliziert
nichts. Ausgenommen ist das Senden von Nachrichten: Jeder Aufruf erzeugt
bewusst eine neue Nachricht.
Die CLI spricht Ihren Workspace über dieselbe Webadresse wie die Browser-App
an (https://<workspace-domain>/api); Sie konfigurieren nie Ports oder
API-Pfade. Geben Sie einfach Ihre Workspace-Domain an, zum Beispiel yourworkspace
für yourworkspace.hansa.chat, und der Rest funktioniert.
Mit einem Befehl installieren
curl -fsSL https://downloads.hansachat.com/cli/install.sh | sh
Der Installer erkennt Ihre Plattform (macOS oder Linux, Intel oder Apple
Silicon), prüft die Prüfsumme des Downloads und installiert das Programm nach
~/.local/bin. Mit HANSA_INSTALL_DIR wählen Sie ein anderes Verzeichnis.
Sie können das Archiv auch direkt von der Download-Seite
herunterladen und das Programm hansa selbst entpacken.
Ihre ersten Befehle
# Am Workspace anmelden (fragt nach E-Mail und Passwort)
hansa chat login --workspace yourworkspace
# Bestätigen, wer Sie sind
hansa chat whoami
# Erkunden
hansa chat channels list
hansa chat messages list --channel general
--workspace akzeptiert einen Kurznamen (yourworkspace wird zu yourworkspace.hansa.chat)
oder eine vollständige Domain. Nach der ersten erfolgreichen Anmeldung wird
diese als Standard gespeichert, sodass Sie das Flag danach weglassen können.
Mit hansa context use wechseln Sie den Standard.