Le CLI Lytos

Le CLI est la façon dont Lytos atterrit dans un vrai dépôt. Un lyt init scaffold les cinq piliers en dossiers, détecte votre stack, écrit le bon fichier d’adaptateur pour votre outil IA (CLAUDE.md, .cursor/rules/lytos.mdc, AGENTS.md…), et installe un hook pre-commit pour que le nommage des branches reste cohérent.

Installation

npm install -g lytos-cli

Ou sans installation :

npx lytos-cli init

Le binaire lyt est le nom court (on peut aussi utiliser lytos ou lytos-cli si vous préférez).

Commandes

Commande	Ce qu’elle fait
`lyt init`	Scaffold `.lytos/` — interactif, détecte votre stack, propose EN ou FR
`lyt board`	Régénère `BOARD.md` à partir du frontmatter des issues
`lyt lint`	Valide la structure et le contenu de `.lytos/`
`lyt doctor`	Diagnostic complet — fichiers manquants, liens cassés, mémoire obsolète, score de santé
`lyt show ISS-XXXX`	Affiche le détail d’une issue avec une barre de progression
`lyt start ISS-XXXX`	Démarre une issue — la déplace en in-progress, crée la branche, met à jour le board
`lyt claim ISS-XXXX`	S’assigne une issue (vérifie aussi la fraîcheur d’origin pour éviter les claims concurrents)
`lyt close ISS-XXXX`	Clôt une issue validée — la promeut en `5-done` depuis `4-review` (ou explicitement depuis `3-in-progress`)
`lyt close`	Ferme en batch toutes les issues de `4-review/` — demande confirmation, `--yes` skippe
`lyt upgrade`	Met à jour les skills et rules bundlés dans `.lytos/`

Pages clés


Vue d’ensemble	Ce que fait le CLI, en un coup d’œil
`lyt init`	Tout ce que fait le scaffolder — fichiers d’adaptateur, détection de stack, hook pre-commit
`lyt board`	Comment la vue kanban est régénérée à partir du frontmatter

Principes de conception

Offline-first — toutes les commandes sauf lyt init (qui récupère les fichiers bundlés) et lyt claim/start (qui vérifient origin) fonctionnent sans réseau.
Sortie pour humains ET machines — chaque commande a une sortie par défaut pour humain et un flag --json pour CI et scripts.
Échouer avec du contexte — les erreurs disent ce qui ne va pas, où, et comment le corriger.
Une responsabilité par commande — lint valide, doctor diagnostique, ils ne se recouvrent pas.