Repomix Skill:一条命令把整个代码库打包喂给 AI 的开源神器
总结
Repomix 是一款将整个代码仓库压缩为 AI 友好格式的开源 CLI 工具,只需一条命令即可把任意规模的项目打包成结构化的单个文件,直接喂给 Claude、ChatGPT、DeepSeek 等大模型,解决”文件太多、上下文窗口装不下”的痛点。截至 2026-08-19,GitHub 斩获 27,949 Stars、1,491 Forks,是当前 AI 代码理解工作流中最受欢迎的辅助工具之一。
功能与原则
Repomix 的核心功能是代码库压缩打包:将项目所有文件合并为单一 AI 友好格式输出,同时提供文件级和全局 Token 计数。它的设计原则是零门槛 + 安全优先:一行命令即用,内置 Secretlint 自动剔除含凭证/密钥的文件,并支持 Tree-sitter 语法压缩,大幅节省 Token 用量。
认可度
- GitHub Star:27,949(截至 2026-08-19)
- Forks:1,491
- NPM 周下载量:持续高速增长(具体数字随时间波动)
- 行业荣誉:入围 JSNation Open Source Awards 2025 “Powered by AI” 类别
- 社区热度:Discord 活跃,GitHub Commits 4,353 次,Chrome/Firefox 浏览器扩展累计安装数万
链接
GitHub:https://github.com/yamadashy/repomix
原作者
- GitHub Username:yamadashy
- 定位:独立开源开发者,专注于 AI 工程化工具链
- 关联项目:yamadashy 还维护了 CodeRabbit 集成、DeepWiki 文档等生态工具
介绍
传统的 AI 辅助代码分析有三大难题:文件太多复制粘贴繁琐、上下文窗口紧张、容易遗漏 .gitignore 配置的敏感文件。Repomix 用一条命令解决全套:它自动读取 .gitignore、.ignore、.repomixignore 配置,只打包应该暴露的代码;输出格式支持 XML(Claude 最擅长解析)、Markdown 和纯文本三种,可按场景选择;Tree-sitter 压缩模式还能提取函数签名和类结构,剔除冗余实现细节,在保持代码逻辑完整的同时最大化节省 Token。
Repomix 还提供网页版(repomix.com)和浏览器扩展,无需安装即可在线打包任意 GitHub 仓库,直接获取 Token 计数和格式预览。对于团队协作场景,可将 repomix-output.xml 配合 Claude Artifacts 使用,实现多文件并行生成。
特点
- 一行命令:
npx repomix@latest或repomix,零配置开箱即用 - 多格式输出:XML(默认)、Markdown、Plain Text,按模型适配自由切换
- Git 感知:自动尊重 .gitignore/.ignore/.repomixignore,不泄露敏感配置
- Token 计数:每个文件 + 全局 Token 计数,精准把控上下文用量
- 安全扫描:内置 Secretlint,自动排除含凭证格式的文件
- Tree-sitter 压缩:
--compress选项提取代码结构而非全文,极致节省 Token - 跨平台支持:npm / yarn / bun / Homebrew 多包管理器,macOS/Linux/Windows 全覆盖
- 在线版 + 浏览器扩展:无需安装,Chrome/Firefox 一键打包 GitHub 仓库
使用方法
最小安装(无需全局安装):
# 在任意项目目录运行
npx repomix@latest
全局安装(重复使用):
npm install -g repomix # 或 yarn global add / bun add -g / brew install repomix
repomix # 在项目目录直接运行
指定输出格式和压缩:
repomix --output-format markdown --compress
配合 AI 使用:
生成 repomix-output.xml 后,直接发给 AI:
This file contains all the files in the repository combined into one.
I want to refactor the code, so please review it first.
使用场景与人群
适用场景:
– 大型代码库重构规划(需 AI 具备全局视野)
– 接手陌生项目,快速生成架构说明文档
– 安全审计(跨文件漏洞传播链路分析)
– Code Review 辅助(AI 全面阅读项目上下文)
– AI 代码生成任务(结合 Claude Artifacts 输出多文件)
目标用户:
– 维护中大型代码库的工程师
– 需要 AI 辅助做重构、架构审查的技术负责人
– 安全研究员(代码审计场景)
– 独立开发者(快速让 AI “读懂” 自己项目)
输入与输出案例
案例 1:中型项目打包
cd /my-nextjs-app
npx repomix@latest
输出:repomix-output.xml,包含所有业务组件、页面、配置文件,按文件结构组织,全局 Token 计数显示 38,200 tokens(未压缩)或 12,450 tokens(–compress 模式)。
案例 2:安全审计场景
repomix --include "src/**/*.ts" --output-format markdown
AI 收到完整 TypeScript 源码包后,可自动识别:某文件暴露了明文 API Key、某处存在 SQL 拼接风险、某模块权限校验缺失,形成完整审计报告。
GitHub:https://github.com/yamadashy/repomix | Stars:27,949(截至 2026-08-19)
评论区
登录后可评论。