CLI-Referenz · Befehle

auth

Anmelden, prüfen, als wer die CLI spricht, und den Token für andere Programme ausgeben. Tokens erstellst du in der Web-App unter Benutzermenü → Tokens. Wo sie liegen, steht unter User-Config.

Speichert einen persönlichen Token für eine Instanz und prüft ihn vorher mit GET /me.

workban auth login

login akzeptiert nur persönliche Tokens (wb_p_…) und ignoriert bewusst Tokens aus Umgebung oder Config. Ohne --token fragt es im Terminal nach. Die Instanz kommt aus --api-url, WORKBAN_API_URL, der .workban.toml des aktuellen Repos oder ist die Produktionsadresse, nie die zuletzt benutzte. Nennt nur die .workban.toml eine noch unbekannte Instanz, fragt login vor dem Senden nach (siehe Welche Instanz gilt).

Der Token landet unter dem Workspace, für den er gilt. Beim ersten Workspace einer Instanz wird er zum Standard-Token, weitere Workspaces kommen dazu, ohne den Standard zu ändern. Mehr unter Mehrere Workspaces.

Beispiele

workban auth login --token wb_p_…                                  # Produktion
workban auth login --api-url http://localhost:3000/api/v1 --token wb_p_…   # lokale Instanz

Fehler

Bedingung	Meldung
Kein Token und kein Terminal	`Token fehlt: workban auth login --token wb_p_…` (Exit-Code 2)
Kein persönlicher Token	`Das ist kein persönlicher Token (erwartet wb_p_ + 32 Zeichen)` (Exit-Code 2)
Instanz lehnt ab	`<instanz> lehnt den Token ab. …` mit der geprüften Adresse (Exit-Code 3)

workban auth status

Zeigt User, Rolle, Workspace, API-Adresse, Token-Präfix und das Projekt aus der .workban.toml.

workban auth status

Ist das Konto in mehreren Workspaces, listet die Zeile „Weitere" die anderen (GET /me/workspaces) und markiert die, für die noch kein Token gespeichert ist. Mit --json stehen sie unter workspaces, jeweils mit token und default. workban me ist ein Alias.

User:       Anna Berg <anna@example.com> @anna
Rolle:      owner (personal_token)
Workspace:  Demo-Team (demo-team), Standard
Weitere:    kunde
API:        https://workban.de/api/v1
Token:      wb_p_a8Kx92Qm…
Projekt:    workban  (/Users/anna/code/workban/.workban.toml)

workban auth header

Gibt den Authorization-Header mit dem Token dieser Instanz aus, für Programme, die im Namen des Users mit Workban sprechen.

workban auth header [Optionen]

Optionen

--httpSchalter
als Header-Zeile für curl -H statt als JSON

Ohne Option ein JSON-Objekt {"Authorization":"Bearer wb_p_…"}, wie es der headersHelper von Claude Code erwartet, mit --http die Zeile Authorization: Bearer wb_p_… für curl -H. Workban Guard lädt so sein Plugin von guard.workban.de. Mit --api-url https://workban.de/api/v1 ist die Instanz fest, egal in welchem Ordner das andere Programm den Befehl startet.

Die Ausgabe enthält den Token im Klartext. Sie gehört nie in Logs, Tickets oder den Verlauf eines Agenten.

curl -H "$(workban auth header --http)" https://workban.de/api/v1/me

workban auth logout

Entfernt den Token, den die CLI an dieser Stelle benutzen würde: für die Instanz aus --api-url und den Workspace aus --workspace, der Umgebung oder der .workban.toml, sonst den Standard-Token.

workban auth logout

Ein anderer Workspace wird dabei nie von selbst zum Standard. Ist kein Token mehr übrig, löscht die CLI die Config-Datei.

workban auth logout                      # Standard-Token bzw. Workspace dieses Repos
workban auth logout --workspace kunde    # nur den Token von kunde

workban me

Kurzform für workban auth status.

workban me