Aller au contenu

Référence CLI

Toutes les commandes de traitement de source acceptent --header-language c|cpp pour les fichiers .h. La valeur par défaut est c ; choisissez cpp pour les en-têtes C++ nommés .h. Les autres extensions ne sont pas affectées. Voir prise en charge des langages pour la politique de sélection et les capacités d’extraction testées.

Lance l’interface utilisateur terminal interactive (TUI), qui vous guide à travers les commandes et options disponibles.

Fenêtre de terminal
codeknit

Extrait les informations structurelles du code source dans des fichiers .skt ou JSON.

Fenêtre de terminal
codeknit parse <input-path> [output-dir]
Flag Type Default Description
--output-mode string directory-flat Mode de sortie : inline, directory-flat ou directory-tree
--format string skt Format de sortie : skt ou json
--max-lines int 500 Nombre maximal de lignes par fichier de sortie (s’applique aux modes directory-flat et directory-tree)
--collect-test bool false Inclure les fichiers de test dans l’analyse
--minify bool false Activer la minification de la sortie basée sur un dictionnaire
--edges bool false Inclure la section [edges] dans la sortie (désactivée par défaut pour économiser des tokens)
--clean bool false Supprimer les fichiers .skt obsolètes du répertoire de sortie avant l’écriture
--workers int 0 (NumCPU) Nombre maximal de goroutines de parsing concurrentes
--verbose bool false Afficher les informations de progression pendant le traitement

Le répertoire de sortie par défaut est ./skeleton lorsqu’il n’est pas spécifié. En mode inline, la sortie est écrite sur stdout et aucun répertoire n’est utilisé. Avec --format json, la sortie en répertoire est écrite sous forme de codeknit.json.

Génère une visualisation interactive en HTML de la structure du codebase.

Fenêtre de terminal
codeknit graph show <input-path>
Flag Type Default Description
-o, --output string ./skeleton/codeknit-graph.html Chemin du fichier HTML de sortie
--collect-test bool false Inclure les fichiers de test dans l’analyse
--workers int 0 (NumCPU) Nombre maximal de goroutines de parsing concurrentes
--verbose bool false Afficher les informations de progression pendant le traitement

Le fichier HTML généré est autonome et s’ouvre automatiquement dans votre navigateur par défaut.

Exécute des algorithmes d’analyse structurelle et émet un rapport .skt lisible par un LLM.

Fenêtre de terminal
codeknit graph analyze <input-path>
Flag Type Default Description
-o, --output string ./skeleton/graph_analysis.skt Chemin du fichier .skt de sortie
--collect-test bool false Inclure les fichiers de test dans l’analyse
--workers int 0 (NumCPU) Nombre maximal de goroutines de parsing concurrentes
--verbose bool false Afficher les informations de progression pendant le traitement
--fan-threshold int 10 Seuil minimal de fan-in ou fan-out pour signaler un symbole hub
--god-threshold int 15 Nombre minimal d’arêtes de type contains pour signaler une god class ou une god function
--max-inheritance-depth int 5 Signaler les chaînes d’héritage plus profondes que cette valeur
--top-n int 30 Limiter les sections de sortie classées ; 0 signifie aucune limite
--betweenness-threshold float64 0.001 Valeur minimale de centralité d’intermédiarité à rapporter
--propagation-cutoff float64 0.05 Probabilité minimale pour poursuivre la simulation de propagation des changements

Classe les fichiers en utilisant l’historique Git et l’importance structurelle, et rapporte le couplage temporel entre les fichiers qui changent souvent ensemble.

Fenêtre de terminal
codeknit graph hotspots <input-path>
Flag Type Default Description
-o, --output string ./skeleton/hotspots.skt Chemin du fichier de sortie
--format string skt Format de sortie : skt ou json
--since string 12mo Fenêtre d’historique, telle que 180d, 12mo ou 2y
--max-commits int 2000 Nombre maximal de commits à inspecter
--max-files-per-commit int 50 Exclure les commits modifiant plus de fichiers
--min-cochanges int 3 Nombre minimal de commits partagés pour le couplage temporel
--top-n int 30 Nombre maximal de résultats par section de rapport
--include-merges bool false Inclure les commits de fusion
--collect-test bool false Inclure les fichiers de test
--workers int 0 (NumCPU) Nombre maximal de goroutines de parsing concurrentes
--verbose bool false Afficher les informations de progression

Détecte les doublons et les quasi-doublons de code en utilisant le fuzzy hashing.

Fenêtre de terminal
codeknit fingerprint <input-path>
Flag Type Default Description
-o, --output string ./skeleton/fingerprints.skt Chemin du fichier .skt de sortie
--min-similarity int 65 Pourcentage minimal de similarité à rapporter (0–100)
--max-similarity int 95 Pourcentage maximal de similarité à rapporter (0–100)
--show-all bool false Inclure la section [fingerprints] avec les données brutes de tokens
--rerank bool false Trouver les voisins sémantiques et reclasser les candidats en utilisant les embeddings Ollama (nécessite ollama serve et ollama pull qwen3-embedding:0.6b)
--model string qwen3-embedding:0.6b Modèle d’embedding Ollama à utiliser avec --rerank
--collect-test bool false Inclure les fichiers de test dans l’analyse
--workers int 0 (NumCPU) Nombre maximal de goroutines de parsing concurrentes
--verbose bool false Afficher les informations de progression pendant le traitement

Génère des scripts de complétion pour les shells pris en charge.

Fenêtre de terminal
codeknit completion <shell>

Shells pris en charge : bash, zsh, fish, powershell.

Flag Description
--version Affiche les informations de version
--help, -h Affiche l’aide pour la commande en cours