Le thème Codex CLI ne s’applique pas ? Résolvez-le en 5 étapes

La commande /theme ne renvoie aucun résultat, les couleurs ne changent pas ou la palette semble incorrecte ? Les problèmes liés aux thèmes de Codex CLI sont presque toujours dus à l’un de ces cinq causes. Voici comment diagnostiquer et résoudre chacun d’eux, dans l’ordre.

1. Le thème n’est pas installé (cause la plus fréquente)

La commande /theme n’affiche que les thèmes présents dans le répertoire des thèmes de Codex CLI. Si vous n’avez jamais exécuté de script d’installation, la liste est vide ou ne contient que le thème par défaut.

Solution : installez d’abord une palette :

curl -fsSL https://raw.githubusercontent.com/vufly/bearded-theme-ports/master/scripts/install-codex.sh | sh

Ensuite, rouvrez l’invite de commandes et exécutez à nouveau /theme — la nouvelle palette devrait apparaître sous son nom exact.

2. Cache des couleurs obsolète au démarrage

Certains ports mettent en cache les couleurs dès le lancement de Codex CLI. Après l’application d’un thème, la palette peut sembler incorrecte jusqu’au prochain redémarrage.

Solution : redémarrez Codex CLI après avoir appliqué le thème, puis exécutez à nouveau /theme avec le même nom. Si la bonne palette s’affiche, c’est bien le cache qui était responsable.

3. Le nom du thème ne correspond pas exactement

La commande /theme effectue une correspondance exacte des noms de thèmes. Tokyo Night n’est pas équivalent à tokyo-night ni à TokyoNight.

Solution : exécutez /theme sans argument, copiez le nom exact depuis la liste affichée, puis appliquez-le tel quel.

4. Fichier de palette incorrect ou incomplet

Une palette copiée depuis un script de portage peut être incomplète — il peut manquer des clés comme background, foreground ou celles relatives à la coloration syntaxique. Cela se traduit par des couleurs majoritairement par défaut, avec seulement une ou deux modifications visibles.

Solution : réexécutez le script d’installation pour récupérer la palette complète, ou utilisez un gestionnaire afin de valider le fichier :

# Codex Themes CLI valide la palette avant toute application :
codex-theme validate <name>
codex-theme apply <name>

5. Désynchronisation entre le terminal et Codex CLI

Si le terminal affiche correctement les couleurs mais pas Codex CLI (ou inversement), cela signifie que les deux lisent des configurations différentes. Les thèmes CLI ne sont que des palettes — ils ne modifient pas votre profil de terminal.

Solution : exportez la même palette vers les deux environnements. Codex Themes CLI peut écrire les mêmes couleurs directement dans votre profil de terminal, ce qui permet de synchroniser les deux surfaces en une seule opération :

codex-theme export <name> --to-terminal

Toujours bloqué(e) ?

Réinitialisez l’état à zéro : désinstallez la palette, redémarrez, réinstallez-la, puis appliquez-la avec son nom exact. Si un skin particulier pose problème, consultez la catégorie Mono & Terminal pour découvrir les dernières variantes de palettes, ou référez-vous au guide des thèmes Codex CLI pour connaître l’intégralité du processus d’installation.