Codexplain : le projet pour faire parler Codex comme Claude Code

En utilisant Codex, j’ai souvent eu l’impression qu’il corrigeait bien le code, mais que ses explications donnaient parfois envie de se demander : « Au final, qu’est-ce que ça veut dire ? »
Trois points me gênaient particulièrement.

1. Explications centrées sur les noms de fichiers et de fonctions
   • Codex explique souvent par unité de fichier, comme README.md, rust/codexplain.rs ou package.json, plutôt que d’expliquer « comment une fonctionnalité fonctionne de bout en bout ». Quand on connaît déjà la structure du projet, ça va, mais sur une codebase qu’on découvre, il fallait souvent reposer des questions.
2. Du texte difficile à lire dans le terminal
   • Avec des explications structurées comme dans Claude Code — TLDR, tableaux, diagrammes, panneau de risques, prochaines actions — la lecture est bien plus rapide, mais celles de Codex ressemblent souvent davantage à du texte en continu.
3. La conclusion arrive tard et il y a trop de détails inutiles
   • L’utilisateur veut d’abord savoir « ce qu’il faut comprendre maintenant », mais Codex donne souvent tout le contexte d’un seul coup.

C’est pour cela que j’ai créé Codexplain.

Codexplain n’est pas un modèle qui remplace Codex, mais une couche UX d’explication qui reformate localement les réponses de Codex pour les rendre plus faciles à lire.

Fonctionnalités principales :

• mise en forme des explications en TLDR / résumé / tableau / diagramme d’architecture / risk panel / next action
• préservation telle quelle des artifacts stricts comme JSON, code, diff, patch, log et test output
• réglage de l’explanation depth, de l’architecture depth et de l’abstraction level
• semantic highlight pensé pour le terminal
• configuration locale au projet basée sur codexplain/
• possibilité pour une équipe ou un individu d’ajouter un custom explanation style
• activation/désactivation locale et désinstallation possibles

Installation :

npm install -g codexplain
codexplain install-codex --local --force

Si, en utilisant Codex, vous vous êtes déjà dit « le code est correct, mais l’explication est trop peu claire », essayez-le et ouvrez une issue pour signaler ce qui manque ou le style d’explication que vous aimeriez avoir ! Les étoiles sont toujours les bienvenues ⭐️