CLI-Referenz

Befehle

codexspec show-blueprint

Gibt die vollständige .codexspec/blueprint.md aus dem festen Branch codexspec/auto-dev und worktree-for-codexspec-auto-dev unverändert auf der Standardausgabe aus. Fehlende Voraussetzungen werden auf der Standardfehlerausgabe mit einem Status ungleich null gemeldet. Der Befehl ist schreibgeschützt und führt weder Fetch, Merge, Schreibzugriffe noch Sperren aus.

codexspec show-blueprint

---

codexspec init

Ein neues CodexSpec-Projekt initialisieren.

codexspec init [PROJECT_NAME] [OPTIONEN]

Argumente:

Argument	Beschreibung
PROJECT_NAME	Name für Ihr neues Projektverzeichnis (. oder --here für das aktuelle Verzeichnis)

Optionen:

Option	Kurz	Beschreibung
--here	-h	Im aktuellen Verzeichnis initialisieren
--ai	-a	Zu verwendender AI-Assistent: claude, codex oder both (Standard: claude)
--lang	-l	Basis-Ausgabesprache; interaction/document/commit fallen darauf zurück (z. B. en, zh-CN, ja)
--interaction-lang		Interaktionssprache (LLM-Dialog + codexspec CLI-Ausgabe); überschreibt --lang
--document-lang		Dokumentensprache (generierte Anforderungen/Spec/Plan/Tasks); überschreibt --lang
--commit-lang		Commit-Nachrichten-Sprache; überschreibt --lang
--force	-f	Vorhandene Dateien überschreiben und Prompts automatisch bestätigen; config.yml wird nie neu erzeugt
--no-git		Git-Repository-Initialisierung überspringen
--debug	-d	Debug-Ausgabe aktivieren

--lang legt die Basis-Sprache output fest; --interaction-lang, --document-lang und --commit-lang überschreiben sie für ihre jeweilige Dimension (jede fällt auf output, dann auf en zurück). Siehe Internationalisierung für das vollständige Modell.

Die erstmalige Initialisierung in einem TTY ohne --lang (und ohne alle drei Dimensions-Flags) fragt nach einer Basissprache; in einem Nicht-TTY (CI/Skripte) wird standardmäßig en verwendet – vollständig nicht-interaktiv. Ein erneuter init-Aufruf behält jeden Sprach-Schlüssel bei, den Sie nicht angegeben haben; --force erzeugt config.yml nie neu.

Beispiele:

# Neues Projekt erstellen
codexspec init my-project

# Im aktuellen Verzeichnis initialisieren
codexspec init . --ai claude

# Einmalige Verwendung (ohne Installation) – für Codex CLI oder both initialisieren
uvx codexspec init . --ai codex
uvx codexspec init . --ai both

# Vollständig nicht-interaktiv: zh-CN-Basis, englische Commit-Nachrichten
codexspec init my-project --lang zh-CN --commit-lang en

# Jede Dimension explizit festlegen (skriptbar, keine Prompts)
codexspec init my-project \
  --interaction-lang zh-CN --document-lang en --commit-lang en

---

codexspec check

Auf installierte Tools prüfen.

codexspec check

---

codexspec version

Versionsinformationen anzeigen.

codexspec version

---

codexspec config

Projektkonfiguration anzeigen oder ändern.

codexspec config [OPTIONEN]

Optionen:

Option	Kurz	Beschreibung
--set-lang	-l	Die Basis-Ausgabesprache festlegen
--set-interaction-lang		Die Interaktionssprache festlegen (LLM-Dialog + CLI-Ausgabe)
--set-document-lang		Die Dokumentensprache festlegen (generierte Spec/Plan/Tasks)
--set-commit-lang	-c	Die Commit-Nachrichten-Sprache festlegen
--list-langs		Alle unterstützten Sprachen auflisten
--auto-next		workflow.auto_next umschalten/setzen (bare schaltet um; oder on/off)

Jedes --set-*-lang aktualisiert eine Sprach-Dimension; jede Dimension, die Sie nicht festlegen, fällt auf output, dann auf en zurück.