Référence CLI

Commandes

codexspec show-blueprint

Affiche le fichier .codexspec/blueprint.md complet de la branche fixe codexspec/auto-dev et de worktree-for-codexspec-auto-dev directement sur la sortie standard. Les prérequis absents sont signalés sur la sortie d'erreur avec un état non nul. La commande est en lecture seule et n'effectue aucun fetch, merge, verrouillage ou écriture.

codexspec show-blueprint

---

codexspec init

Initialise un nouveau projet CodexSpec.

codexspec init [PROJECT_NAME] [OPTIONS]

Arguments :

Argument	Description
PROJECT_NAME	Nom du nouveau répertoire de projet (utilisez . ou --here pour le répertoire courant)

Options :

Option	Raccourci	Description
--here	-h	Initialiser dans le répertoire courant
--ai	-a	Assistant AI à utiliser : claude, codex ou both (par défaut : claude)
--lang	-l	Langue de sortie (base) ; interaction/document/commit s'y rapportent (ex. en, zh-CN, ja)
--interaction-lang		Langue d'interaction (dialogue LLM + sortie CLI codexspec) ; surcharge --lang
--document-lang		Langue des documents (exigences/spec/plan/tasks générés) ; surcharge --lang
--commit-lang		Langue des messages de commit ; surcharge --lang
--force	-f	Écraser les fichiers existants et confirmer automatiquement les invites ; ne régénère jamais config.yml
--no-git		Passer l'initialisation du dépôt git
--debug	-d	Activer la sortie de débogage

--lang définit la langue de base output ; --interaction-lang, --document-lang et --commit-lang la surchargent pour leur dimension (chacune se rabat sur output, puis sur en). Voir Internationalisation pour le modèle complet.

La première initialisation dans un TTY sans --lang (et sans les trois indicateurs de dimension) demande une langue de base ; dans un environnement non-TTY (CI/scripts) elle utilise en par défaut — entièrement non interactive. Relancer init préserve toute clé de langue que vous n'avez pas explicitement fournie ; --force ne régénère jamais config.yml.

Exemples :

# Créer un nouveau projet
codexspec init my-project

# Initialiser dans le répertoire courant
codexspec init . --ai claude

# Usage ponctuel (sans installation) — initialiser pour Codex CLI ou les deux
uvx codexspec init . --ai codex
uvx codexspec init . --ai both

# Entièrement non interactif : base zh-CN, messages de commit en anglais
codexspec init my-project --lang zh-CN --commit-lang en

# Définir chaque dimension explicitement (scriptable, sans invite)
codexspec init my-project \
  --interaction-lang zh-CN --document-lang en --commit-lang en

---

codexspec check

Vérifie les outils installés.

codexspec check

---

codexspec version

Affiche les informations de version.

codexspec version

---

codexspec config

Affiche ou modifie la configuration du projet.

codexspec config [OPTIONS]

Options :

Option	Raccourci	Description
--set-lang	-l	Définir la langue de sortie (base)
--set-interaction-lang		Définir la langue d'interaction (dialogue LLM + sortie CLI)
--set-document-lang		Définir la langue des documents (spec/plan/tasks générés)
--set-commit-lang	-c	Définir la langue des messages de commit
--list-langs		Lister toutes les langues prises en charge
--auto-next		Basculer/définir workflow.auto_next (à nu bascule ; ou on/off)

Chaque --set-*-lang met à jour une dimension de langue ; toute dimension que vous ne définissez pas se rabat sur output, puis sur en.