Riferimento CLI

codeknit

Avvia l’interfaccia utente terminale interattiva (TUI), che guida attraverso i comandi e le opzioni disponibili.

codeknit

codeknit parse

Estrae informazioni strutturali dal codice sorgente in file .skt o JSON.

codeknit parse <input-path> [output-dir]

Flag	Tipo	Default	Descrizione
--output-mode	string	directory-flat	Modalità di output: inline, directory-flat o directory-tree
--format	string	skt	Formato di output: skt o json
--max-lines	int	500	Numero massimo di righe per file di output (si applica alle modalità directory-flat e directory-tree)
--collect-test	bool	false	Includi i file di test nell’analisi
--minify	bool	false	Abilita la minimizzazione dell’output basata su dizionario
--edges	bool	false	Includi la sezione [edges] nell’output (disattivata per impostazione predefinita per risparmiare token)
--clean	bool	false	Rimuovi i file .skt obsoleti dalla directory di output prima della scrittura
--workers	int	0 (NumCPU)	Numero massimo di goroutine di parsing concorrenti
--verbose	bool	false	Mostra informazioni di avanzamento durante l’elaborazione

La directory di output predefinita è ./skeleton quando non specificata. In modalità inline, l’output viene scritto su stdout e nessuna directory viene utilizzata. Con --format json, l’output della directory viene scritto come codeknit.json.

codeknit graph show

Genera una visualizzazione interattiva in HTML della struttura del grafo della codebase.

codeknit graph show <input-path>

Flag	Tipo	Default	Descrizione
-o, --output	string	./skeleton/codeknit-graph.html	Percorso del file HTML di output
--collect-test	bool	false	Includi i file di test nell’analisi
--workers	int	0 (NumCPU)	Numero massimo di goroutine di parsing concorrenti
--verbose	bool	false	Mostra informazioni di avanzamento durante l’elaborazione

Il file HTML generato è autonomo e si apre automaticamente nel browser predefinito.

codeknit graph analyze

Esegue algoritmi di analisi strutturale e genera un report .skt leggibile da LLM.

codeknit graph analyze <input-path>

Flag	Tipo	Default	Descrizione
-o, --output	string	./skeleton/graph_analysis.skt	Percorso del file .skt di output
--collect-test	bool	false	Includi i file di test nell’analisi
--workers	int	0 (NumCPU)	Numero massimo di goroutine di parsing concorrenti
--verbose	bool	false	Mostra informazioni di avanzamento durante l’elaborazione
--fan-threshold	int	10	Soglia minima di fan-in o fan-out per segnalare un simbolo hub
--god-threshold	int	15	Conteggio minimo di archi “contains” per segnalare una god class/function
--max-inheritance-depth	int	5	Segnala catene di ereditarietà più profonde di questo valore
--top-n	int	30	Limita le sezioni di output classificate; 0 significa nessun limite
--betweenness-threshold	float64	0.001	Valore minimo di betweenness centrality da riportare
--propagation-cutoff	float64	0.05	Probabilità minima per continuare la simulazione di propagazione delle modifiche

codeknit fingerprint

Rileva codice duplicato e quasi duplicato utilizzando fuzzy hashing.

codeknit fingerprint <input-path>

Flag	Tipo	Default	Descrizione
-o, --output	string	./skeleton/fingerprints.skt	Percorso del file .skt di output
--min-similarity	int	65	Percentuale minima di similarità da riportare (0–100)
--max-similarity	int	95	Percentuale massima di similarità da riportare (0–100)
--show-all	bool	false	Includi la sezione [fingerprints] con i dati grezzi dei token
--rerank	bool	false	Riordina i candidati CTPH utilizzando embedding semantici tramite Ollama (richiede ollama serve e ollama pull qwen3-embedding:0.6b)
--model	string	qwen3-embedding:0.6b	Modello di embedding Ollama da utilizzare con --rerank
--collect-test	bool	false	Includi i file di test nell’analisi
--workers	int	0 (NumCPU)	Numero massimo di goroutine di parsing concorrenti
--verbose	bool	false	Mostra informazioni di avanzamento durante l’elaborazione

codeknit completion

Genera script di completamento per shell supportate.

codeknit completion <shell>

Shell supportate: bash, zsh, fish, powershell.

Flag globali

Flag	Descrizione
--version	Mostra le informazioni sulla versione
--help, -h	Mostra l’aiuto per il comando corrente