Chuyển đến nội dung

yamadashy / repomix

Repomix

Gói cả dự án code thành một file duy nhất để đưa cho ChatGPT, Claude, Gemini hỏi và nhờ sửa

Repomix là công cụ gom toàn bộ mã nguồn của một dự án thành một file duy nhất, định dạng sẵn cho AI dễ đọc, kèm số token (mẩu chữ AI đọc/viết) của từng file và của cả kho. Bạn dùng được qua lệnh trong Terminal, trang web repomix.com, tiện ích trình duyệt cho GitHub hoặc Docker. Nó tôn trọng .gitignore và dùng Secretlint để loại file có dạng khoá bí mật. Giấy phép MIT.

  • 29.277 sao
  • 1.646 fork
  • TypeScript
  • Cập nhật hôm qua
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Vừa Cần gõ vài lệnh hoặc dùng Docker
Dạng
Dòng lệnh (CLI), Tiện ích trình duyệt
Chạy trên
Windows, macOS, Linux, Node.js, Docker, Web
Chi phí
Miễn phí hoàn toàn

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

  1. 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.

    Terminal
    npx repomix@latest
  2. Mở 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

  1. Cài bằng npm để dùng lệnh repomix ở mọi thư mục.

    Terminal
    npm install -g repomix
  2. Trên macOS hoặc Linux có thể dùng Homebrew thay thế.

    Terminal
    brew install repomix
  3. Chạy trong thư mục dự án bất kỳ.

    Terminal
    repomix

Cài trên Trang web và tiện ích

  1. Mở repomix.com, nhập tên kho GitHub, chọn định dạng đầu ra rồi bấm nút Pack.

    Văn bản
    https://repomix.com
  2. Hoặ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

  1. Chạy trong container, gắn thư mục hiện tại vào /app.

    Terminal
    docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix
  2. Gói một kho từ xa và lưu kết quả vào thư mục output.

    Terminal
    docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix

Dùng thử lần đầu

  1. Mở Terminal trong một dự án nhỏ và chạy repomix để gói toàn bộ dự án.

    Terminal
    npx repomix@latest
  2. Đọc phần tổng kết trong Terminal: số file, số token và các file lớn nhất.

  3. Chỉ gói các file TypeScript và Markdown bằng mẫu glob.

    Terminal
    repomix --include "src/**/*.ts,**/*.md"
  4. Dự án quá lớn thì thêm tuỳ chọn nén để giảm số token.

    Terminal
    repomix --compress
  5. Gử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.

Terminal
git clone https://github.com/yamadashy/repomix.git

Repo tương tự nên xem

Tài liệu, OCR & hỏi đáp tri thức196K

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.

VừaWindowsmacOSLinuxPython
AI hỗ trợ lập trình156K

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

VừaWindowsmacOSLinux
AI hỗ trợ lập trình50,1K

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

KhóWindowsmacOSLinuxPython

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI hỗ trợ lập trình

AI hỗ trợ lập trình325K

Matt Pocock Skills

mattpocock / skills

Bộ skill nhỏ gọn giúp trợ lý AI viết code hỏi kỹ yêu cầu, viết test trước và giữ code gọn gàng

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình318K

Superpowers

obra / superpowers

Bộ kỹ năng biến trợ lý AI thành người làm phần mềm bài bản: hỏi ý, lập kế hoạch, viết test, rồi mới code

VừaWindowsmacOSLinux
AI hỗ trợ lập trình304K

ECC (Everything Claude Code)

affaan-m / ECC

Kho agent, skill, hook và quy tắc dựng sẵn để trợ lý AI lập trình làm việc có quy trình và có kiểm tra

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình233K

Karpathy-Inspired Claude Code Guidelines

multica-ai / andrej-karpathy-skills

Một file CLAUDE.md gồm bốn nguyên tắc giúp Claude Code bớt đoán mò, bớt làm phức tạp và sửa đúng chỗ cần sửa

DễWindowsmacOSLinux
AI hỗ trợ lập trình227K

OpenCode

anomalyco / opencode

Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình195K

Anthropic Agent Skills

anthropics / skills

Kho skill mẫu chính thức của Anthropic: dạy Claude làm Word, Excel, PDF, PowerPoint và việc chuyên biệt

DễWindowsmacOSLinuxWeb+1

Xem cả 30 repo AI hỗ trợ lập trình Về Kho Repo