CLI-Referenz · Befehle

init

Ein Repository einmal mit einem Workban-Projekt verbinden. Danach finden Menschen und Agenten im Repo das richtige Projekt ohne weitere Angaben, und Claude Code arbeitet nur mit laufendem Task.

workban init

Fragt nach Workspace und Projekt, schreibt die .workban.toml und die Dateien für die Agenten: Regel, Skill, die Abschnitte in CLAUDE.md und AGENTS.md und die Hooks.

workban init [Optionen]

Optionen

--no-agentsSchalter
Regel, Skill und die Abschnitte in CLAUDE.md und AGENTS.md nicht schreiben
--no-hooksSchalter
Claude-Code-Hooks in .claude/settings.json nicht eintragen (Riegel: Änderungen nur mit laufendem Task)
--updateSchalter
nur Regel, Skill und Hooks auf den Stand der CLI heben: keine Fragen, kein Login, .workban.toml bleibt
--dir <path>Wert
Zielverzeichnis, sonst Git-Wurzel oder aktuelles Verzeichnis

init darf beliebig oft laufen und ergänzt dann die Dateien. Bestehende Dateien werden ergänzt, nicht überschrieben.

Workspace und Projekt

init klärt zuerst den Workspace und bietet danach dessen Projekte an.

Workspace: Ihn nennen --workspace, WORKBAN_WORKSPACE oder workspace einer schon vorhandenen .workban.toml. Ein ausdrücklicher Token (--token, WORKBAN_TOKEN) gehört ohnehin zu genau einem. Nennt nichts einen und ist das Konto in mehreren Workspaces, fragt init im Terminal nach. Die Liste zeigt jeden aktiven Workspace mit Name, Slug und Rolle, den Standard und „kein Token" bei denen, für die diese Maschine noch keinen Token hat.
Projekt: Gibt es genau eins, nimmt init es ohne Frage. Die Auswahl bietet mit n an, direkt ein neues Projekt anzulegen, wenn die Rolle das darf (ab Maintainer, aus permissions in GET /me).
Instanz: Ohne --api-url spricht init mit der Produktionsinstanz oder der Instanz aus einer vorhandenen .workban.toml, nie mit der zuletzt benutzten.

Workspaces:
  1) Demo-Team (demo-team), owner, Standard
  2) Kunde GmbH (kunde), member
Workspace wählen [1]: 1
  1) Website (website)
  2) Workban (workban)
  n) Neues Projekt anlegen
Projekt wählen [1]: 2
Projekt Workban (workban) in Demo-Team verbunden (https://workban.de/api/v1).

Was init schreibt

.workban.toml mit project, workspace und, außer bei der Produktionsadresse, api_url.
.claude/rules/workban.md: der volle Vertrag für Claude Code, bei jedem Sessionstart geladen.
.claude/skills/workban/SKILL.md: wie die Befehle zu benutzen sind.
Einen Verweis in CLAUDE.md und den vollen Vertrag als Abschnitt in AGENTS.md.
Zwei Hooks in .claude/settings.json: workban hook gate und workban hook session.

--no-agents lässt Regel, Skill und die Abschnitte weg, --no-hooks die Hooks.

Nach einem CLI-Update

init --update hebt Regel, Skill, die Abschnitte in CLAUDE.md und AGENTS.md und die Hooks auf den Stand der installierten CLI. Es fragt nichts, braucht keinen Token und keine API und lässt die .workban.toml unberührt. Das Projekt kommt aus der .workban.toml. Ab 0.49 erledigt das der Sessionstart von selbst (Automatisches Update); von Hand braucht es den Befehl, wenn das Automatische ausgeschaltet ist. workban doctor nennt ihn, wenn die Dateien im Repo veraltet sind.

Beispiele

workban init                          # fragt nach Workspace und Projekt
workban init --project workban        # ohne Rückfrage
workban init --workspace kunde        # Repo eines anderen Workspaces verbinden
workban init --no-hooks               # ohne Claude-Code-Hooks
workban init --update                 # nach workban update: Dateien auf den neuen Stand heben

Fehler

Bedingung	Meldung
Kein Terminal, mehrere Projekte	`Mehrere Projekte, bitte --project angeben: …` (Exit-Code 2)
Kein Terminal, mehrere angemeldete Workspaces	`Mehrere Workspaces, bitte --workspace angeben: …` (Exit-Code 2)
Gewählter Workspace ohne Token	`Für <Name> (<slug>) gibt es auf dieser Maschine noch keinen Token. …` (Exit-Code 3)
Token gehört zu einem anderen Workspace	`Der Token gehört zum Workspace …, gewählt ist …` (Exit-Code 3)
`--update` ohne `.workban.toml`	`Keine .workban.toml gefunden. Erst workban init ausführen …` (Exit-Code 2)