Référence CLI¶
Commandes¶
codexspec init¶
Initialise un nouveau projet CodexSpec.
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 version¶
Affiche les informations de version.
codexspec config¶
Affiche ou modifie la configuration du projet.
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.