Repomix:把整个仓库打包成一份上下文
结论
Repomix 解决的是「让 AI 一次看到完整仓库」这件事。它把目录树、文件内容和 token 统计合成一个文件,省掉逐个贴文件的来回;真正要小心的是打包范围,而不是命令本身。
它解决什么问题
跨文件重构、代码审查和架构梳理时,只给几个文件往往不够:模型看不到调用方,也看不到配置和文档之间的关系。手动拼接又容易漏文件、丢路径,还无法预估 token。Repomix 按 .gitignore 收集文件,输出 XML、Markdown、JSON 或纯文本;单文件形式可以直接上传,也可以作为其他分析工具的输入。
我的实验
在这个站点仓库根目录执行:
npx repomix@1.19.0 . --style markdown --compress --output repomix-output.md
结果是 90 个文件、97,462 tokens、318,481 字符;安全扫描报告没有可疑文件。占用最多的是 .claude/skills/ 下的技能说明和 docs/design.md,说明仓库体积主要来自文档而不是代码。--compress 用 Tree-sitter 抽取签名和结构,输出比完整文件短,但实现细节也被裁掉了。这个统计本身也有用:接近模型上下文上限时,可以先按目录拆分,而不是盲目加大窗口。
限制
- 默认尊重
.gitignore,但content/是已跟踪目录,私人写作也会被打包。发给外部模型前要用--ignore或.repomixignore排除。 --compress会抽取结构,长实现细节会被裁掉,不适合逐行审查。- 仓库稍大就会接近上下文上限,需要 include/exclude 或分目录打包。
- 安全扫描只能发现常见的密钥形式,不能代替人工检查;打包结果仍要当作可能包含敏感信息的文件对待。
适合谁
需要让模型快速理解一个中小型仓库的人。只想看单文件或单模块时,直接给文件更省 token。