repomix-rs 是什么

repomix-rs 是一款将整个代码库打包为 AI 友好单文件的工具。它能同时适用于 Hermes Agent、Claude、ChatGPT、Gemini 等主流大模型应用场景。通过 repomix-rs，你的代码库将以结构化、Token 可控的方式呈现给 AI，以便 AI 更精准地进行代码审查、文档生成与漏洞排查。

和原版 Repomix 相比，repomix-rs 用 Rust 重写了全部核心逻辑，在性能、安全性、嵌入能力上均有质的飞跃。

Rust：AI 时代的基础设施选择

你是否注意到一个趋势？越来越多的开发者生态基础设施正在从 TypeScript/Node.js 转向 Rust。

这不是偶然，而是 Rust 语言特性对 AI 时代的需求完美契合：

为什么开发者选择 Rust？

1. 编译期性能保障 —— 零成本抽象 + 无 GC 停顿
2. 内存安全保障 —— 编译期消除 BufferOverflow / Use-After-Free
3. 跨平台单二进制 —— 一次编译，随处运行
4. MCP 时代的核心选择 —— AI Agent 生态正在形成新的技术标准

Rust 替代案例：从 Bun 到 Vite

Bun 案例：Node.js 的 Rust 替代者

Rust 实现的高性能运行时 Bun 用 Rust 重写 JavaScript 引擎，带来：

• 启动速度：Node.js ~2s → Bun ~0.1s
• 执行速度：JavaScript ~2x → Bun ~5-10x
• 内存占用：Node.js ~600MB → Bun ~200-500MB

Bun 的成功证明了 Rust 作为 JS 引擎底层的可行性，而 repomix-rs 正是利用 Rust 的高性能特性实现了 repomix 的重构。

Vite 案例：前端构建的 Rust 重构

Webpack 是前端构建的霸主，但它存在：

• 启动慢：5-30s
• 内存占用：500-2000MB
• Node.js 单线程瓶颈

Vue.js 团队决定抛弃 Webpack，用 Rust 重写 Vite：

• 启动速度：5-30s → ~0.5s
• 内存占用：500-2000MB → ~200MB
• 并发处理能力：事件循环 → 多线程

Vite 的成功证明了 Rust 是下一代前端构建引擎的核心选择。

快速启动：不用装，直接跑

打开终端，进入项目根目录，执行以下任意一行：

运行后会在当前目录生成输出文件（默认 repomix-output.xml），将该文件拖入 Hermes Agent 聊天窗口，并发送："请先读一下这个项目结构文件"。

为什么推荐使用 repomix-rs？

在 Hermes Agent 这样的 AI Agent 场景下，我们推荐使用 Rust 版本的 repomix-rs，而不是 TypeScript 原版：

• 更小的镜像体积：Rust 二进制约 15MB vs Node.js 运行时 50+MB
• 更快的启动速度：Rust ~0.05s vs Node.js ~200ms
• 更小的内存占用：Rust ~50MB vs Node.js ~150MB
• 更好的 MCP 原生支持：repomix-rs 直接内置 MCP Server

这就是技术选择的问题 —— Bun 和 Vite 的成功已经证明： 在 AI 时代，Rust 是更好的基础设施选择。

远程仓库直打

无需克隆，一行命令即可打远程 GitHub 仓库：

指定分支（更稳妥）：

repomix-rs 的远程打包基于系统 git 命令实现，首次运行会完整拉取仓库快照。 若 git 不可用，该步骤会跳过并给出警告，不会中断主流程。

精细控制：哪些文件该进，哪些该砍

创建 .repomixrc 配置文件：

启用压缩（提取函数签名，压缩率可达 50%-90%）：

仅包含特定语言文件并忽略测试目录：

输出格式选择

repomix-rs 支持四种输出格式，通过 --style 参数切换：

npx repomix-rs --style markdown --output output.md .
npx repomix-rs --style json   --output output.json .
npx repomix-rs --style plain  --output output.txt .

如何接入 Hermes Agent（关键步骤）

Hermes Agent 不会自动扫描附件内容，必须手动触发。正确流程如下：

1. 运行 npx repomix-rs . 生成打包文件
2. 将 repomix-output.xml（或 .md / .txt）拖入 Hermes Agent 聊天窗口
3. 发送提示："请先读一下这个项目结构文件"
4. 等 Hermes 回复"已加载上下文"后，再提出具体需求

提示：Hermes 仅支持纯文本格式的 .md / .xml / .txt 文件。 若误发压缩包或二进制文件，AI 端无法解析。

作为 MCP Server 运行（推荐给高级用户）

repomix-rs 内置 MCP Server，可直接嵌入任何支持 Model Context Protocol 的 AI Agent（包括 Hermes Agent、Cursor、Claude Desktop）：

启动后会暴露以下 MCP 工具：

Cursor / Claude Desktop 配置

Claude Desktop（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

Cursor

进入 Settings → MCP → Add new global MCP server：

性能对比：原版 vs repomix-rs

为什么推荐 repomix-rs 而不是原版 Repomix？

1. 速度无可比拟 —— Rust 零成本抽象 + rayon 并行 + tokio 异步 I/O，相同仓库打包时间仅为原版的 1/10 甚至更低。
2. 原生 MCP 支持 —— 一行命令 repomix --mcp，直接接入 Hermes、Claude、Cursor 等，无需任何额外包装层。
3. 更安全的依赖树 —— Rust 二进制无需 Node.js 运行时，部署简单、CVE 风险低。
4. 完全兼容原版 CLI —— 参数名、配置文件格式、输出格式几乎无差异，切换零学习成本。
5. Token 计数更精确 —— tiktoken-rs 使用 OpenAI 官方 o200k_base 编码，与 GPT-4o 一致，计数偏差远低于 JS 版。

常见问题

Q: npx repomix-rs 和 npx repomix 有什么区别？

A: npx repomix-rs 调用 repomix-rs（Rust 实现），更快更稳定；npx repomix 调用原版 TypeScript 实现。两者命令行参数基本兼容。

Q: 我的 Node.js 项目能用 repomix-rs 吗？

A: 完全可以，语言无关。repomix-rs 通过文件扩展名和 glob 规则识别文件类型。

Q: 如何验证 exclude 规则是否生效？

A: 生成输出后进行 grep 检查：grep -i "secrets\|password\|API_KEY" repomix-output.xml。如果出现敏感词，检查 glob 规则是否正确（如 **/.env，而非 .env）。

Q: repomix-rs 支持 Windows 吗？

A: 支持，Windows x64 已发布预编译二进制。npm 包也横跨 Linux/macOS/Windows。