Repomix 完整介绍

Repomix 是一个强大的开源工具，能将整个代码仓库打包成单个 AI 友好文件，专为将代码库输入大语言模型（LLM）而设计。

核心价值主张

Repomix 解决了一个关键问题：开发者需要将大型代码库高效地提供给 Claude、ChatGPT、Gemini 等 AI 工具进行代码审查、文档生成、测试开发等任务。传统方法要么复制粘贴（效率低），要么上传多个文件（不便管理），Repomix 通过一条命令将整个仓库合并为 AI 优化格式。

主要功能特性

1. 多格式输出

Repomix 支持四种输出格式满足不同需求：

2. Token 计数与优化

• 实时 Token 统计：精确计算每个文件和整个仓库的 token 数，确保不超过 LLM 上下文限制
• Token 树状图：--token-count-tree 命令显示 token 分布，帮助识别最大的文件
• 代码压缩：--compress 使用 Tree-sitter 提取关键代码结构（函数签名、类定义等），能减少约 70% 的 token 使用量

3. 安全与过滤

• Git 感知：自动遵守 .gitignore、.ignore、.repomixignore 文件规则
• 安全扫描：集成 Secretlint 检测敏感信息（API 密钥、密码等），防止意外泄露
• 灵活排除：支持 glob 模式精确控制包含/排除哪些文件

4. 大规模仓库支持

• 输出分割：--split-output 1mb 自动将大型输出分成多个文件
• 远程仓库打包：无需克隆即可直接处理 GitHub 仓库
• 流式输入：--stdin 选项支持通过管道接收文件列表

访问方式与安装

CLI 工具（推荐）

# 快速尝试（无需安装）
npx repomix@latest

# 全局安装（npm）
npm install -g repomix

# Homebrew 安装（macOS/Linux）
brew install repomix

# Docker 方式
docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

Web 界面

访问 repomix.com，可在浏览器中快速尝试，无需任何安装。

浏览器与编辑器扩展

• Chrome 扩展：在 GitHub 页面上添加一键 Repomix 按钮
• VSCode 扩展：Repomix Runner 允许直接在编辑器中运行
• MCP 服务器：集成到 Claude Desktop、Cursor 等 AI 工具

典型应用场景

1. 代码审查与重构

repomix
# 然后上传输出文件给 AI，输入提示词：
# "请审查这个代码库的整体结构并建议重构机会"

2. 自动化文档生成

# AI 可基于完整代码库生成详细的 README、架构文档等

3. 测试用例生成

# 分析代码结构，AI 可生成全面的单元测试（包括边界情况）

4. 快速库概览

repomix --remote facebook/react --compress
# 快速获得任意开源项目的核心架构理解

5. 代码质量评估

# 检查代码是否符合最佳实践、可读性、性能等

高级功能

AI 工具集成

MCP 服务器（Model Context Protocol）：允许 AI 助手直接与代码库交互

repomix --mcp
# 配置到 Claude Desktop、Cursor、VS Code 等

Claude 官方插件：

• repomix-mcp：MCP 服务器基础
• repomix-commands：斜杠命令快捷操作
• repomix-explorer：AI 驱动的仓库分析

Agent Skills 生成：为 Claude 创建可复用的代码库参考

repomix --skill-generate my-project-reference

Git 历史集成

# 包含 Git 日志（默认 50 条）
repomix --include-logs

# 包含代码变更（diff）
repomix --include-diffs

这对 AI 理解代码演化和开发模式很有帮助。

配置文件支持

Repomix 支持灵活的配置文件格式（优先级顺序）：

1. TypeScript：repomix.config.ts（最佳体验，完整类型检查）
2. JavaScript：repomix.config.js（支持动态值）
3. JSON：repomix.config.json（最简单）

可通过 repomix --init 快速初始化配置文件。

社区与支持

• 官方网站：repomix.com
• Discord 社区：分享使用经验、获取帮助、讨论新功能
• 开源大奖：已被提名 JSNation Open Source Awards 2025 的"Powered by AI"类别

对于 Python 用户

Repomix 主要针对 JavaScript/TypeScript 项目优化。Python 用户可考虑 Gitingest，它更适合 Python 生态和数据科学工作流。

总体评价：Repomix 是开发者与 AI 协作的必备工具。它通过高度优化的打包方案、精确的 token 计数和多层安全检查，让将复杂代码库输入 LLM 变得简单高效。无论是快速代码审查还是大规模项目分析，Repomix 都能显著提升工作流效率。