Repomix 安装指南从 npx 到 Docker 与浏览器扩展的完整部署方案【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomixRepomix 是一款将整个代码仓库打包为单一、AI 友好文件XML/Markdown/JSON/Plain Text的命令行工具便于将代码库直接喂给 Claude、ChatGPT、DeepSeek 等 LLM 使用。本文以官方安装文档为主体结合本仓库源码与配置系统讲解 Repomix 的全部安装途径npx 免安装运行、npm/Yarn/pnpm/Bun/Homebrew 全局安装、Docker 容器化部署、VS Code 扩展、浏览器扩展以及安装完成后的验证方法读完即可根据自身环境快速上手。安装前置条件系统要求在开始安装之前需要先确认环境满足 Repomix 的最低要求Node.js≥ 22.0.0。该版本约束同时体现在文档与仓库的 package.json 的engines字段node: 22.0.0中。值得注意的是仓库中的 CLI 启动脚本 bin/repomix.cjs 会对 Node.js 主版本号做运行时检查当主版本低于 20 时会打印警告并提示部分功能可能无法按预期工作因此建议始终使用 Node.js 22 及以上版本。Git处理远程仓库时必需。当使用--remote处理 GitHub 等远程仓库时Repomix 需要依赖本机 Git 完成克隆与归档操作这一点在官方 基本使用指南 的远程仓库章节中有详细说明。方式一使用 npx 免安装运行如果只是临时使用或想先体验一下无需任何安装步骤直接用 npx 即可npx repomixlatestnpx会临时下载 repomix 的最新发布版本并立即执行不会污染全局环境。该命令默认在当前目录下运行将整个仓库打包输出为repomix-output.xml。这种方式非常适合 CI 流水线、临时任务或首次体验场景。方式二全局安装npm / Yarn / pnpm / Bun / Homebrew如果需要长期、频繁使用 Repomix推荐将其安装为全局命令之后便可在任意目录直接执行repomix。官方提供了五种包管理器安装方式# npm npm install -g repomix # Yarn yarn global add repomix # pnpm pnpm add -g repomix # Bun bun add -g repomix # HomebrewmacOS brew install repomix安装后repomix命令即全局可用。从仓库结构看npm 包通过 package.json 中的bin: ./bin/repomix.cjs字段将可执行入口暴露为repomix命令该入口脚本会启用 Node.js 编译缓存NODE_COMPILE_CACHE以加速重复启动并注册uncaughtException、unhandledRejection、SIGINT/SIGTERM 等错误与退出处理逻辑见 bin/repomix.cjs。方式三Docker 容器化安装对于不希望在本机安装 Node.js 环境、或需要在隔离环境中运行的用户官方提供了开箱即用的 Docker 镜像这是避免环境配置问题最便捷的方式之一。镜像仓库为ghcr.io/yamadashy/repomix常见用法如下# 处理当前目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix # 处理指定目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory # 处理远程仓库输出挂载到 ./output 目录 docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix参数含义说明-v .:/app将宿主机当前目录挂载到容器内工作目录/app使 Repomix 能读取你的代码并写入打包结果-it以交互模式运行便于查看打包进度与提示--rm容器运行结束后自动删除避免残留--remote yamadashy/repomix直接指定要打包的远程仓库用户/仓库名缩写形式输出文件写入挂载的./output目录。仓库根目录的 Dockerfile 揭示了镜像的构建细节基于node:22-slim基础镜像额外安装git与ca-certificates这正是远程仓库处理所需的 Git 依赖随后安装依赖、执行npm link将 repomix 链接到全局、清理开发依赖以减小镜像体积最终以ENTRYPOINT [repomix]作为容器入口并在构建阶段分别执行repomix --version与repomix --help验证 CLI 可正常运行。方式四VS Code 扩展社区维护开发者可以直接在 VS Code 中运行 Repomix无需切换到终端。官方推荐社区维护的Repomix Runner扩展通过 VS Code 应用商店搜索 Repomix Runner 即可安装。其主要特性包括只需点击几下即可打包任意文件夹可选择文件模式或内容模式进行复制自动清理输出文件原生支持repomix.config.json配置文件与命令行行为一致。安装后在 VS Code 中对目标文件夹右键即可触发打包适合在编辑器工作流中高频使用的场景。方式五浏览器扩展Chrome / FirefoxRepomix 还提供了浏览器扩展可直接从任意 GitHub 仓库页面一键访问 Repomix扩展会在 GitHub 仓库页面注入一个 Repomix 按钮点击后即跳转到 Repomix 在线服务并自动带入当前仓库地址免去复制 URL 的麻烦。安装途径Chrome通过 Chrome 应用商店搜索 Repomix 扩展安装Firefox通过 Firefox 附加组件Add-ons商店搜索 Repomix 安装。工作方式与源码佐证该扩展的完整源码位于仓库的 browser 目录采用 Manifest V3 规范开发支持 Chrome、Firefox、Edge 多浏览器。核心注入逻辑在 browser/entrypoints/content.ts 中实现关键流程如下页面匹配content script 声明匹配https://github.com/*在document_start阶段注入并监听 DOM 变化仓库识别通过解析window.location.pathname提取owner/repo并校验当前是否为仓库页面排除用户主页、组织页等按钮注入借助MutationObserver监听 GitHub 动态导航变化在导航容器中插入带 Repomix 图标的按钮见 browser/entrypoints/content.ts跳转组装按钮链接指向 Repomix 在线服务并携带?repo参数编码的仓库 URL。此外扩展的 README 声明其不收集任何数据、不追踪用户行为、仅访问 github.com、权限最小化可在浏览器设置中查看其权限声明。扩展本身也支持本地开发与构建npm run build chrome后可在chrome://extensions/以加载已解压的扩展方式手动加载dist/chrome目录。验证安装是否成功无论选择哪种安装方式安装完成后都应立即验证 Repomix 是否正常工作repomix --version repomix --helprepomix --version输出当前版本号。从源码看该命令由 src/cli/actions/versionAction.ts 实现通过 src/core/file/packageJsonParse.ts 解析包根目录的package.json读取version字段当前仓库版本为1.18.0见 package.jsonrepomix --help输出完整的命令行帮助信息涵盖所有可用选项与参数说明。两条命令执行成功且无报错即代表安装完成、命令已加入 PATH。若提示command not found请检查全局 bin 目录是否已加入系统 PATH或改用npx repomix方式运行。安装完成后的下一步安装并验证成功后即可开始使用。官方推荐按以下路径循序渐进基本使用学习如何打包目录、远程仓库、指定文件、Git diff、分割输出、查看 Token 计数等核心操作配置指南通过repomix --init生成repomix.config.json按需自定义打包行为命令行选项查阅完整的 CLI 参数参考。对于更进阶的使用方式如代码压缩、注释移除、安全扫描等可继续阅读仓库中 website/client/src/en/guide 目录下的其他指南文档。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Repomix 安装指南：从 npx 到 Docker 与浏览器扩展的完整部署方案
Repomix 安装指南从 npx 到 Docker 与浏览器扩展的完整部署方案【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomixRepomix 是一款将整个代码仓库打包为单一、AI 友好文件XML/Markdown/JSON/Plain Text的命令行工具便于将代码库直接喂给 Claude、ChatGPT、DeepSeek 等 LLM 使用。本文以官方安装文档为主体结合本仓库源码与配置系统讲解 Repomix 的全部安装途径npx 免安装运行、npm/Yarn/pnpm/Bun/Homebrew 全局安装、Docker 容器化部署、VS Code 扩展、浏览器扩展以及安装完成后的验证方法读完即可根据自身环境快速上手。安装前置条件系统要求在开始安装之前需要先确认环境满足 Repomix 的最低要求Node.js≥ 22.0.0。该版本约束同时体现在文档与仓库的 package.json 的engines字段node: 22.0.0中。值得注意的是仓库中的 CLI 启动脚本 bin/repomix.cjs 会对 Node.js 主版本号做运行时检查当主版本低于 20 时会打印警告并提示部分功能可能无法按预期工作因此建议始终使用 Node.js 22 及以上版本。Git处理远程仓库时必需。当使用--remote处理 GitHub 等远程仓库时Repomix 需要依赖本机 Git 完成克隆与归档操作这一点在官方 基本使用指南 的远程仓库章节中有详细说明。方式一使用 npx 免安装运行如果只是临时使用或想先体验一下无需任何安装步骤直接用 npx 即可npx repomixlatestnpx会临时下载 repomix 的最新发布版本并立即执行不会污染全局环境。该命令默认在当前目录下运行将整个仓库打包输出为repomix-output.xml。这种方式非常适合 CI 流水线、临时任务或首次体验场景。方式二全局安装npm / Yarn / pnpm / Bun / Homebrew如果需要长期、频繁使用 Repomix推荐将其安装为全局命令之后便可在任意目录直接执行repomix。官方提供了五种包管理器安装方式# npm npm install -g repomix # Yarn yarn global add repomix # pnpm pnpm add -g repomix # Bun bun add -g repomix # HomebrewmacOS brew install repomix安装后repomix命令即全局可用。从仓库结构看npm 包通过 package.json 中的bin: ./bin/repomix.cjs字段将可执行入口暴露为repomix命令该入口脚本会启用 Node.js 编译缓存NODE_COMPILE_CACHE以加速重复启动并注册uncaughtException、unhandledRejection、SIGINT/SIGTERM 等错误与退出处理逻辑见 bin/repomix.cjs。方式三Docker 容器化安装对于不希望在本机安装 Node.js 环境、或需要在隔离环境中运行的用户官方提供了开箱即用的 Docker 镜像这是避免环境配置问题最便捷的方式之一。镜像仓库为ghcr.io/yamadashy/repomix常见用法如下# 处理当前目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix # 处理指定目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory # 处理远程仓库输出挂载到 ./output 目录 docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix参数含义说明-v .:/app将宿主机当前目录挂载到容器内工作目录/app使 Repomix 能读取你的代码并写入打包结果-it以交互模式运行便于查看打包进度与提示--rm容器运行结束后自动删除避免残留--remote yamadashy/repomix直接指定要打包的远程仓库用户/仓库名缩写形式输出文件写入挂载的./output目录。仓库根目录的 Dockerfile 揭示了镜像的构建细节基于node:22-slim基础镜像额外安装git与ca-certificates这正是远程仓库处理所需的 Git 依赖随后安装依赖、执行npm link将 repomix 链接到全局、清理开发依赖以减小镜像体积最终以ENTRYPOINT [repomix]作为容器入口并在构建阶段分别执行repomix --version与repomix --help验证 CLI 可正常运行。方式四VS Code 扩展社区维护开发者可以直接在 VS Code 中运行 Repomix无需切换到终端。官方推荐社区维护的Repomix Runner扩展通过 VS Code 应用商店搜索 Repomix Runner 即可安装。其主要特性包括只需点击几下即可打包任意文件夹可选择文件模式或内容模式进行复制自动清理输出文件原生支持repomix.config.json配置文件与命令行行为一致。安装后在 VS Code 中对目标文件夹右键即可触发打包适合在编辑器工作流中高频使用的场景。方式五浏览器扩展Chrome / FirefoxRepomix 还提供了浏览器扩展可直接从任意 GitHub 仓库页面一键访问 Repomix扩展会在 GitHub 仓库页面注入一个 Repomix 按钮点击后即跳转到 Repomix 在线服务并自动带入当前仓库地址免去复制 URL 的麻烦。安装途径Chrome通过 Chrome 应用商店搜索 Repomix 扩展安装Firefox通过 Firefox 附加组件Add-ons商店搜索 Repomix 安装。工作方式与源码佐证该扩展的完整源码位于仓库的 browser 目录采用 Manifest V3 规范开发支持 Chrome、Firefox、Edge 多浏览器。核心注入逻辑在 browser/entrypoints/content.ts 中实现关键流程如下页面匹配content script 声明匹配https://github.com/*在document_start阶段注入并监听 DOM 变化仓库识别通过解析window.location.pathname提取owner/repo并校验当前是否为仓库页面排除用户主页、组织页等按钮注入借助MutationObserver监听 GitHub 动态导航变化在导航容器中插入带 Repomix 图标的按钮见 browser/entrypoints/content.ts跳转组装按钮链接指向 Repomix 在线服务并携带?repo参数编码的仓库 URL。此外扩展的 README 声明其不收集任何数据、不追踪用户行为、仅访问 github.com、权限最小化可在浏览器设置中查看其权限声明。扩展本身也支持本地开发与构建npm run build chrome后可在chrome://extensions/以加载已解压的扩展方式手动加载dist/chrome目录。验证安装是否成功无论选择哪种安装方式安装完成后都应立即验证 Repomix 是否正常工作repomix --version repomix --helprepomix --version输出当前版本号。从源码看该命令由 src/cli/actions/versionAction.ts 实现通过 src/core/file/packageJsonParse.ts 解析包根目录的package.json读取version字段当前仓库版本为1.18.0见 package.jsonrepomix --help输出完整的命令行帮助信息涵盖所有可用选项与参数说明。两条命令执行成功且无报错即代表安装完成、命令已加入 PATH。若提示command not found请检查全局 bin 目录是否已加入系统 PATH或改用npx repomix方式运行。安装完成后的下一步安装并验证成功后即可开始使用。官方推荐按以下路径循序渐进基本使用学习如何打包目录、远程仓库、指定文件、Git diff、分割输出、查看 Token 计数等核心操作配置指南通过repomix --init生成repomix.config.json按需自定义打包行为命令行选项查阅完整的 CLI 参数参考。对于更进阶的使用方式如代码压缩、注释移除、安全扫描等可继续阅读仓库中 website/client/src/en/guide 目录下的其他指南文档。【免费下载链接】repomix Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.项目地址: https://gitcode.com/GitHub_Trending/rep/repomix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考