一个命令行工具,扫描代码库并生成精简的 AI 上下文文件,减少编程助手探索项目时消耗的 token。
yamadashy/repomix
将整个代码仓库打包成单个 AI 友好文件,方便输入给 Claude、ChatGPT 等大模型的命令行与网页工具。
- Star
- 28,913
- Fork
- 1,705
- 未关闭 Issue
- 156
- 最近提交
- 前天
这是什么?
Repomix 可以把整个代码仓库打包成一个文件,支持 XML、Markdown、JSON 和纯文本格式,方便一次性粘贴或上传到大模型对话中。工具会遵循 .gitignore、.ignore 和 .repomixignore 规则,统计每个文件和整个项目的 token 数量,并借助 Secretlint 排除匹配已知凭证格式的文件。
它可以通过 npx 或全局安装使用命令行,也提供 repomix.com 网页版、GitHub 页面的浏览器扩展,以及社区维护的 VS Code 扩展。支持打包本地目录或远程 GitHub 仓库(可指定分支、标签或提交),也能通过 stdin 读取自定义文件列表。
针对大型项目,--compress 选项借助 Tree-sitter 只保留函数和类的签名,去掉实现细节;--split-output 则可将输出拆分为编号文件,以适应工具的文件大小限制。此外,Repomix 还可作为 MCP 服务器运行,让 AI 助手直接打包仓库。
核心功能
- 01将仓库输出为 XML、Markdown、JSON 或纯文本格式。
- 02遵循 .gitignore、.ignore 和 .repomixignore 文件进行过滤。
- 03统计每个文件及整个仓库的 token 数量。
- 04通过 Secretlint 排除匹配已知凭证格式的文件。
- 05使用 --compress 借助 Tree-sitter 将代码压缩为函数和类签名。
- 06支持按分支、标签或提交打包远程 GitHub 仓库。
适用场景
- 把整个代码库交给大模型做代码审查或重构。
- 基于整个项目一次性生成文档或单元测试。
- 检查代码仓库是否能放进模型的上下文窗口。
- 通过 MCP 让 AI 助手直接读取本地或远程仓库。
快速上手
- 1
无需安装,直接在项目目录中试用
npx repomix@latest - 2
或使用 npm 全局安装
npm install -g repomix - 3
在任意项目目录中运行,生成 repomix-output.xml
repomix
使用前须知
- 输出文件可能很大,请对照你所用 LLM 的上下文上限检查 token 数量。
标签
常见问题
- repomix 是什么?
- 将整个代码仓库打包成单个 AI 友好文件,方便输入给 Claude、ChatGPT 等大模型的命令行与网页工具。 Repomix 可以把整个代码仓库打包成一个文件,支持 XML、Markdown、JSON 和纯文本格式,方便一次性粘贴或上传到大模型对话中。工具会遵循 .gitignore、.ignore 和 .repomixignore 规则,统计每个文件和整个项目的 token 数量,并借助 Secretlint 排除匹配已知凭证格式的文件。
- repomix 可以免费使用吗?用的什么许可证?
- repomix 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- repomix 还在维护吗?
- 活跃维护中。repomix 最近一次提交是在 2026年10月18日。
- repomix 适合用来做什么?
- 把整个代码库交给大模型做代码审查或重构。 基于整个项目一次性生成文档或单元测试。 检查代码仓库是否能放进模型的上下文窗口。 通过 MCP 让 AI 助手直接读取本地或远程仓库。
- repomix 怎么安装和运行?
- 无需安装,直接在项目目录中试用: npx repomix@latest 或使用 npm 全局安装: npm install -g repomix 在任意项目目录中运行,生成 repomix-output.xml: repomix
- 在哪里获取 repomix?
- 源代码和安装说明在 GitHub 上:https://github.com/yamadashy/repomix
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一个能从经验中创建并改进技能的自我进化 AI 智能体,支持多种模型服务商,可通过命令行和即时通讯工具使用。
开源的自主编程智能体,可作为 IDE 插件、终端 CLI、桌面应用或 SDK 使用。
可自托管的类 ChatGPT 聊天平台,统一接入多家 AI 模型服务,支持 Agent、MCP 与多用户登录。
终端编程智能体,内置 LSP、调试器、浏览器和子智能体,支持 60 多家模型服务商。
把 Git 仓库或本地目录整理成一份适合喂给大模型的纯文本摘要。