Trải nghiệm khi dùng Repomix
Cách nhanh nhất là mở Terminal (cửa sổ gõ lệnh) trong thư mục dự án và chạy npx repomix@latest mà không cần cài gì. Ít giây sau bạn thấy một file repomix-output.xml xuất hiện, bên trong là toàn bộ code của dự án nối lại có cấu trúc, mở đầu bằng lời giải thích giúp AI hiểu file này là gì. Terminal cũng cho biết số token của từng file và của cả dự án.
Bạn gửi file đó cho một trợ lý AI như Claude, ChatGPT hay Gemini kèm một câu như: đây là toàn bộ mã nguồn của tôi, hãy xem qua rồi đề xuất cách refactor. AI giờ có đủ ngữ cảnh để trả lời về cả dự án thay vì chỉ một đoạn dán vào. README còn gợi ý nhiều mẫu câu hỏi: review code, viết tài liệu, sinh test, đánh giá chất lượng.
Nếu ngại Terminal, bạn có thể vào repomix.com, nhập tên kho GitHub rồi bấm nút Pack để lấy kết quả, hoặc cài tiện ích Chrome và Firefox để có nút Repomix ngay trên trang kho GitHub. Gói quá lớn so với giới hạn của AI thì dùng tuỳ chọn nén để rút gọn mà vẫn giữ cấu trúc.
Tính năng nổi bật
Một lệnh gói cả dự án
Chạy repomix trong thư mục dự án để có một file duy nhất chứa mọi file mã nguồn theo định dạng AI dễ hiểu.
Đếm token
Hiển thị số token của từng file và cả kho, giúp bạn biết có vừa giới hạn ngữ cảnh của mô hình hay không.
Tôn trọng .gitignore
Tự bỏ qua những gì Git đã bỏ qua, và cho phép bạn thêm quy tắc riêng bằng file .repomixignore.
Loại file chứa khoá bí mật
Dùng Secretlint để phát hiện file có dạng thông tin đăng nhập và không đưa vào kết quả, giảm nguy cơ lộ khoá khi gửi cho AI.
Nén code bằng Tree-sitter
Tuỳ chọn nén trích phần cấu trúc quan trọng để giảm số token mà vẫn giữ khung của code.
Nhiều đầu vào, nhiều định dạng
Gói kho từ xa theo địa chỉ GitHub, chọn file bằng mẫu glob, xuất XML, Markdown, JSON hoặc văn bản thường.
Tận dụng Repomix vào việc gì?
Lập trình viên
Nhờ AI review cả dự án
Gói code thành một file rồi nhờ AI đánh giá cấu trúc, chỉ ra chỗ nên refactor hoặc dễ gây lỗi.
Sinh viên, người mới vào dự án
Hiểu nhanh một thư viện lạ
Gói một kho GitHub từ xa và nhờ AI tóm tắt mục đích, tính năng chính và kiến trúc.
Đội phát triển
Viết tài liệu và test tự động
Đưa file đã gói cho AI để sinh README, hướng dẫn sử dụng hoặc bộ unit test cho các hàm chính.
Người dùng công cụ code AI
Cho agent AI bối cảnh dự án
Dùng chế độ MCP hoặc tạo skill theo định dạng Claude Agent Skills để công cụ AI đọc dự án đúng cách.
Người hay hết giới hạn token
Chuẩn bị ngữ cảnh gọn cho dự án lớn
Chọn đúng thư mục, bỏ file không cần và nén để vừa cửa sổ ngữ cảnh của mô hình.
Cần chuẩn bị gì?
- Node.js để chạy lệnh npx hoặc cài bằng npm; có thể thay bằng yarn, bun hoặc Homebrew theo README.
- Hoặc dùng không cần cài gì qua trang repomix.com và tiện ích Chrome/Firefox.
- Docker nếu muốn chạy trong môi trường cô lập.
- Một trợ lý AI (Claude, ChatGPT, Gemini...) để dùng file kết quả.
Hướng dẫn cài đặt chi tiết
Cài trên Dùng ngay không cần cài
Cài Node.js nếu chưa có. Mở Terminal (hoặc PowerShell) trong thư mục dự án và chạy lệnh dưới.
npx repomix@latestMở file repomix-output.xml vừa tạo trong thư mục, hoặc gửi trực tiếp cho trợ lý AI.
Cài trên Cài toàn cục
Cài bằng npm để dùng lệnh repomix ở mọi thư mục.
npm install -g repomixTrên macOS hoặc Linux có thể dùng Homebrew thay thế.
brew install repomixChạy trong thư mục dự án bất kỳ.
repomix
Cài trên Trang web và tiện ích
Mở repomix.com, nhập tên kho GitHub, chọn định dạng đầu ra rồi bấm nút Pack.
https://repomix.comHoặc cài tiện ích cho Chrome hoặc Firefox từ cửa hàng tiện ích chính thức để có nút Repomix trên trang kho GitHub. Tìm Repomix trong Chrome Web Store hoặc Firefox Add-ons.
Cài trên Docker
Chạy trong container, gắn thư mục hiện tại vào /app.
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomixGói một kho từ xa và lưu kết quả vào thư mục output.
docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix
Dùng thử lần đầu
Mở Terminal trong một dự án nhỏ và chạy repomix để gói toàn bộ dự án.
npx repomix@latestĐọc phần tổng kết trong Terminal: số file, số token và các file lớn nhất.
Chỉ gói các file TypeScript và Markdown bằng mẫu glob.
repomix --include "src/**/*.ts,**/*.md"Dự án quá lớn thì thêm tuỳ chọn nén để giảm số token.
repomix --compressGửi file kết quả cho AI kèm câu hỏi, ví dụ: file này chứa toàn bộ code của dự án, hãy giải thích kiến trúc và chỉ ra chỗ dễ lỗi.
Mẹo dùng hay
- Dùng --copy để chép kết quả thẳng vào clipboard rồi dán vào khung chat AI.
- Chạy repomix --init để tạo file cấu hình repomix.config.json lưu các lựa chọn của bạn.
- Gói kho GitHub công khai mà không cần clone bằng cách dùng tuỳ chọn --remote kèm tên kho.
- Muốn dùng trong công cụ AI qua MCP, README có tuỳ chọn --mcp và --sandbox để giới hạn thư mục mà máy chủ được đọc.
Lưu ý và hạn chế
- Toàn bộ code sẽ được đưa vào file gửi cho AI. Dù có Secretlint, hãy tự kiểm tra file kết quả trước khi gửi, đặc biệt với code công ty hoặc có khoá bí mật.
- Dự án lớn có thể vượt giới hạn token của mô hình; hãy chọn lọc file hoặc dùng tuỳ chọn nén.
- Một số trợ lý AI trên web có thể dùng dữ liệu bạn gửi theo chính sách riêng; đọc điều khoản trước khi gửi mã nguồn nội bộ.
Câu hỏi thường gặp
Repomix có miễn phí không?
Có, giấy phép MIT. Bạn chỉ trả tiền (nếu có) cho trợ lý AI mà bạn gửi file tới.
Người không rành lập trình có dùng được không?
Nếu chỉ muốn thử, trang repomix.com cho bạn nhập tên kho GitHub và bấm Pack mà không cần Terminal. Nhưng bản thân việc gói code chủ yếu hữu ích khi bạn làm việc với code.
Code của tôi có bị gửi lên mạng không?
Khi chạy lệnh cục bộ, kết quả nằm trên máy bạn. Chỉ khi bạn tự gửi file cho một dịch vụ AI hoặc dùng trang web thì dữ liệu mới rời máy.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/yamadashy/repomix.gitRepo tương tự nên xem
MarkItDown
microsoft / markitdown
Công cụ của Microsoft đổi PDF, Word, Excel, PowerPoint và nhiều file khác thành Markdown cho AI đọc.
Claude Code
anthropics / claude-code
Trợ lý AI viết code của Anthropic chạy trong Terminal, đọc hiểu dự án, sửa file và xử lý Git bằng lời thường
Aider
Aider-AI / aider
Lập trình cặp với AI ngay trong Terminal: AI sửa code trong dự án và tự commit Git cho bạn