Tài liệu tham chiếu CLI

codeknit

Khởi chạy giao diện terminal tương tác (TUI), hướng dẫn bạn qua các lệnh và tùy chọn có sẵn.

codeknit

codeknit parse

Trích xuất thông tin cấu trúc từ mã nguồn vào các tệp .skt hoặc JSON.

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

Cờ	Kiểu	Mặc định	Mô tả
--output-mode	chuỗi	directory-flat	Chế độ đầu ra: inline, directory-flat, hoặc directory-tree
--format	chuỗi	skt	Định dạng đầu ra: skt hoặc json
--max-lines	int	500	Số dòng tối đa cho mỗi tệp đầu ra (áp dụng cho chế độ directory-flat và directory-tree)
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--minify	bool	false	Bật tính năng tối giản đầu ra dựa trên từ điển
--edges	bool	false	Bao gồm phần [edges] trong đầu ra (tắt theo mặc định để tiết kiệm token)
--clean	bool	false	Xóa các tệp .skt cũ trong thư mục đầu ra trước khi ghi
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	In thông tin tiến trình trong quá trình xử lý

Thư mục đầu ra mặc định là ./skeleton khi không được chỉ định. Trong chế độ inline, đầu ra được ghi ra stdout và không sử dụng thư mục nào. Với --format json, đầu ra thư mục được ghi dưới dạng codeknit.json.

codeknit graph show

Tạo biểu đồ HTML tương tác để trực quan hóa cấu trúc codebase.

codeknit graph show <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	chuỗi	./skeleton/codeknit-graph.html	Đường dẫn tệp HTML đầu ra
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	In thông tin tiến trình trong quá trình xử lý

Tệp HTML được tạo ra là tự chứa và tự động mở trong trình duyệt mặc định của bạn.

codeknit graph analyze

Chạy các thuật toán phân tích cấu trúc và xuất báo cáo .skt có thể đọc được bởi LLM.

codeknit graph analyze <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	chuỗi	./skeleton/graph_analysis.skt	Đường dẫn tệp .skt đầu ra
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	In thông tin tiến trình trong quá trình xử lý
--fan-threshold	int	10	Ngưỡng fan-in hoặc fan-out tối thiểu để gắn cờ ký hiệu trung tâm
--god-threshold	int	15	Số lượng cạnh chứa tối thiểu để gắn cờ god class/function
--max-inheritance-depth	int	5	Gắn cờ các chuỗi kế thừa sâu hơn giá trị này
--top-n	int	30	Giới hạn các phần đầu ra được xếp hạng; 0 nghĩa là không giới hạn
--betweenness-threshold	float64	0.001	Giá trị trung tâm betweenness tối thiểu để báo cáo
--propagation-cutoff	float64	0.05	Xác suất tối thiểu để tiếp tục mô phỏng lan truyền thay đổi

codeknit graph hotspots

Xếp hạng các tệp bằng lịch sử Git và tầm quan trọng cấu trúc, đồng thời báo cáo sự kết hợp thời gian giữa các tệp thường xuyên thay đổi cùng nhau.

codeknit graph hotspots <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	chuỗi	./skeleton/hotspots.skt	Đường dẫn tệp đầu ra
--format	chuỗi	skt	Định dạng đầu ra: skt hoặc json
--since	chuỗi	12mo	Cửa sổ lịch sử, ví dụ: 180d, 12mo, hoặc 2y
--max-commits	int	2000	Số lượng commit tối đa để kiểm tra
--max-files-per-commit	int	50	Loại trừ các commit thay đổi nhiều tệp hơn
--min-cochanges	int	3	Số lượng commit chia sẻ tối thiểu cho kết hợp thời gian
--top-n	int	30	Số lượng kết quả tối đa cho mỗi phần báo cáo
--include-merges	bool	false	Bao gồm các commit merge
--collect-test	bool	false	Bao gồm các tệp kiểm thử
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	In thông tin tiến trình

codeknit fingerprint

Phát hiện mã trùng lặp và gần trùng lặp bằng cách sử dụng fuzzy hashing.

codeknit fingerprint <input-path>

Cờ	Kiểu	Mặc định	Mô tả
-o, --output	chuỗi	./skeleton/fingerprints.skt	Đường dẫn tệp .skt đầu ra
--min-similarity	int	65	Độ tương đồng tối thiểu để báo cáo (0–100)
--max-similarity	int	95	Độ tương đồng tối đa để báo cáo (0–100)
--show-all	bool	false	Bao gồm phần [fingerprints] với dữ liệu token thô
--rerank	bool	false	Tìm các lân cận ngữ nghĩa và xếp hạng lại ứng viên bằng cách sử dụng embeddings Ollama (yêu cầu ollama serve và ollama pull qwen3-embedding:0.6b)
--model	chuỗi	qwen3-embedding:0.6b	Mô hình embedding Ollama để sử dụng với --rerank
--collect-test	bool	false	Bao gồm các tệp kiểm thử trong phân tích
--workers	int	0 (NumCPU)	Số lượng goroutine phân tích tối đa đồng thời
--verbose	bool	false	In thông tin tiến trình trong quá trình xử lý

codeknit completion

Tạo các script hoàn thành shell cho các shell được hỗ trợ.

codeknit completion <shell>

Các shell được hỗ trợ: bash, zsh, fish, powershell.

Cờ toàn cục

Cờ	Mô tả
--version	In thông tin phiên bản
--help, -h	Hiển thị trợ giúp cho lệnh hiện tại