Repomix 安装完全指南从 npx 零安装到 Docker、VS Code 与浏览器扩展的六种部署方式【免费下载链接】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的命令行工具便于将代码库整体交给 Claude、ChatGPT 等 LLM 消费。本文围绕官方安装文档系统讲解六种安装/使用路径npx、npm/Yarn/pnpm/Bun/Homebrew 全局安装、Docker 镜像、VS Code 扩展、浏览器扩展并深入到当前仓库源码验证系统要求、版本命令与容器镜像的实现细节。读完本文你将能够根据本地环境选择最合适的安装方式并完成安装后的环境自检。系统要求先确认运行环境官方安装文档明确给出两条硬性前提这两条要求与仓库内的工程配置完全一致可以从源码中得到印证Node.js ≥ 22.0.0根目录 package.json 中的engines字段声明了node: 22.0.0并附带yarn: 1.22.22的限制同时仓库的 Dockerfile 也以FROM node:22-slim作为基础镜像。如果你通过源码方式构建或作为库被引用Node 版本过低会在安装依赖或运行时直接报错。Git仅当需要处理远程仓库--remote参数时才必需。对应源码位于 src/cli/actions/remoteAction.ts远程模式会执行 git clone/archive 等操作因此官方文档特意标注Git: 处理远程仓库时需要。方式一npx 零安装直接运行最快捷如果只是临时使用、不想在机器上留下全局依赖直接用 npx 拉取最新版即可npx repomixlatest该命令会在当前目录下直接执行打包流程。npx 会把repomix解析为 npm 包的可执行入口对应仓库 package.json 中bin: ./bin/repomix.cjs声明latest标签保证每次拉取到 npm 上的最新发布版本。方式二全局安装npm / Yarn / pnpm / Bun / Homebrew需要长期、高频使用 Repomix 时推荐全局安装之后在任何目录直接敲repomix即可。官方文档提供五种包管理器覆盖 JavaScript 生态主流工具与 macOS 用户# 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 上的repomix发布包其本质与 npx 拉取的包一致区别仅在于是否写入全局node_modules与可执行链接而 Homebrew 渠道则面向 macOS 用户提供了系统级包管理体验二者选其一即可不必重复安装。方式三Docker 容器运行免本地 Node 环境对于不想在本机安装 Node.js、或在 CI/容器化环境里运行的场景官方提供了现成的 Docker 镜像ghcr.io/yamadashy/repomix。官方文档给出的三种典型用法# 1. 打包当前目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix # 2. 打包指定目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory # 3. 打包远程仓库镜像内已内置 Git docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix参数解读-v .:/app把当前目录挂载为容器内的/app工作目录打包结果默认写入该目录下的repomix-output.xml从而直接落到宿主机上-it保持交互式终端输出Repomix 默认会展示打包进度与摘要--rm容器退出后自动清理避免残留容器位置参数path/to/directory与--remote与本地 CLI 的语义完全一致。镜像的构建细节可在仓库根目录 Dockerfile 中查看基础镜像是node:22-slim并通过apt-get安装了git与ca-certificates这正是 Docker 方式支持--remote远程仓库处理的底层原因构建阶段执行npm ci npm link将 repomix 链接为全局命令最后以ENTRYPOINT [repomix]声明容器默认入口因此容器启动即直接执行repomix无需再拼命令名。Dockerfile 中还用RUN repomix --version与RUN repomix --help两行命令在构建阶段自检确保镜像内的 CLI 可用。方式四VS Code 扩展社区维护在 VS Code 内直接打包项目文件夹无需切换到终端。官方文档推荐社区维护的Repomix Runner扩展从 VSCode Marketplace 搜索安装即可仓库中不包含该扩展源码它由社区独立维护。该扩展的核心能力一键打包任意文件夹在资源管理器中右键即可触发免去手敲命令文件 / 内容两种复制模式可选择把打包结果写成文件或直接把内容复制到剪贴板自动清理输出文件重复打包时自动处理旧的输出产物避免堆积兼容repomix.config.json自动读取项目根目录的 Repomix 配置文件沿用你的 include/ignore、输出风格等自定义设置配置文件说明见 configuration 指南。方式五浏览器扩展Chrome / Firefox浏览器扩展面向在 GitHub 网页上即用即走的场景安装后任何 GitHub 仓库页面都会出现一个Repomix按钮点击即可将该仓库交给 Repomix 处理无需本地安装任何 CLI。Chrome在 Chrome Web Store 搜索 Repomix 安装Firefox在 Firefox Add-ons 商店搜索 Repomix 安装。从仓库源码可以印证其实现原理browser/package.json 基于WXT框架构建支持 Chrome、Firefox、Edge 三端功能通过内容脚本Content Script注入实现——browser/entrypoints/content.ts 负责向 GitHub 仓库页面注入按钮browser/utils/github-navigation.ts 负责定位仓库页面的操作栏区域并跳转点击按钮即把当前仓库转交 Repomix 处理。扩展声明权限最小化仅访问 github.com不收集数据具体开发/构建方式npm run build:chrome等见 browser/README.md。官方文档注明更多功能即将推出当前版本聚焦于一键跳转的核心体验。安装后自检验证 CLI 是否就绪无论采用上述哪种方式安装完成后都建议立即执行两条命令确认环境可用repomix --version repomix --help这两条命令的行为可以从源码层面确认repomix --version走的是 src/cli/actions/versionAction.ts 中的runVersionAction它会调用 src/core/file/packageJsonParse.ts 的getVersion()从仓库根目录package.json的version字段读取版本号并打印当前仓库版本为1.18.0。若版本读取失败会降级输出unknown并打印警告日志。repomix --help由 src/cli/cliRun.ts 中的commander程序定义输出帮助信息会按Basic / CLI Input-Output / Repomix Output / File Selection / Remote Repository / Configuration / Security / Token Count / MCP / Watch Mode等分组展示全部参数包括--style、--output、--include、--ignore、--remote、--token-budget等核心选项的默认值与说明完整参数参考见 command-line-options 指南。另外值得注意的一个细节CLI 内置了语义纠错能力。在 src/cli/cliRun.ts 的semanticSuggestionMap中当用户输入了语义相近但非法的参数时如把--ignore写成--exclude、把--output写成--save、把--compress写成--minimize程序会提示 Did you mean: ...? 建议正确选项。这是安装后自检时最容易感受到的贴心设计之一。下一步安装之后怎么用安装并验证通过后建议按以下路径继续上手阅读 基本用法指南了解最常用的repomix、repomix --include、repomix --ignore、repomix --style markdown等实战命令阅读 配置指南通过repomix.config.json固化打包规则配合 VS Code 扩展可开箱即用阅读 命令行选项参考掌握--remote远程仓库、--token-budgetToken 预算护栏、--mcpMCP 服务器模式、-w/--watch监听模式自动重打包等高级能力。总结一下选择建议临时试用选 npx日常高频选全局安装CI 或免环境选 DockerIDE 内操作选 VS Code 扩展纯网页浏览选浏览器扩展——六种方式覆盖了从零体验到工程化接入的全部场景且每种方式的系统要求Node.js ≥ 22、远程场景需 Git与官方文档、仓库配置完全一致可按需放心选用。【免费下载链接】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、VS Code 与浏览器扩展的六种部署方式
Repomix 安装完全指南从 npx 零安装到 Docker、VS Code 与浏览器扩展的六种部署方式【免费下载链接】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的命令行工具便于将代码库整体交给 Claude、ChatGPT 等 LLM 消费。本文围绕官方安装文档系统讲解六种安装/使用路径npx、npm/Yarn/pnpm/Bun/Homebrew 全局安装、Docker 镜像、VS Code 扩展、浏览器扩展并深入到当前仓库源码验证系统要求、版本命令与容器镜像的实现细节。读完本文你将能够根据本地环境选择最合适的安装方式并完成安装后的环境自检。系统要求先确认运行环境官方安装文档明确给出两条硬性前提这两条要求与仓库内的工程配置完全一致可以从源码中得到印证Node.js ≥ 22.0.0根目录 package.json 中的engines字段声明了node: 22.0.0并附带yarn: 1.22.22的限制同时仓库的 Dockerfile 也以FROM node:22-slim作为基础镜像。如果你通过源码方式构建或作为库被引用Node 版本过低会在安装依赖或运行时直接报错。Git仅当需要处理远程仓库--remote参数时才必需。对应源码位于 src/cli/actions/remoteAction.ts远程模式会执行 git clone/archive 等操作因此官方文档特意标注Git: 处理远程仓库时需要。方式一npx 零安装直接运行最快捷如果只是临时使用、不想在机器上留下全局依赖直接用 npx 拉取最新版即可npx repomixlatest该命令会在当前目录下直接执行打包流程。npx 会把repomix解析为 npm 包的可执行入口对应仓库 package.json 中bin: ./bin/repomix.cjs声明latest标签保证每次拉取到 npm 上的最新发布版本。方式二全局安装npm / Yarn / pnpm / Bun / Homebrew需要长期、高频使用 Repomix 时推荐全局安装之后在任何目录直接敲repomix即可。官方文档提供五种包管理器覆盖 JavaScript 生态主流工具与 macOS 用户# 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 上的repomix发布包其本质与 npx 拉取的包一致区别仅在于是否写入全局node_modules与可执行链接而 Homebrew 渠道则面向 macOS 用户提供了系统级包管理体验二者选其一即可不必重复安装。方式三Docker 容器运行免本地 Node 环境对于不想在本机安装 Node.js、或在 CI/容器化环境里运行的场景官方提供了现成的 Docker 镜像ghcr.io/yamadashy/repomix。官方文档给出的三种典型用法# 1. 打包当前目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix # 2. 打包指定目录 docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory # 3. 打包远程仓库镜像内已内置 Git docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote yamadashy/repomix参数解读-v .:/app把当前目录挂载为容器内的/app工作目录打包结果默认写入该目录下的repomix-output.xml从而直接落到宿主机上-it保持交互式终端输出Repomix 默认会展示打包进度与摘要--rm容器退出后自动清理避免残留容器位置参数path/to/directory与--remote与本地 CLI 的语义完全一致。镜像的构建细节可在仓库根目录 Dockerfile 中查看基础镜像是node:22-slim并通过apt-get安装了git与ca-certificates这正是 Docker 方式支持--remote远程仓库处理的底层原因构建阶段执行npm ci npm link将 repomix 链接为全局命令最后以ENTRYPOINT [repomix]声明容器默认入口因此容器启动即直接执行repomix无需再拼命令名。Dockerfile 中还用RUN repomix --version与RUN repomix --help两行命令在构建阶段自检确保镜像内的 CLI 可用。方式四VS Code 扩展社区维护在 VS Code 内直接打包项目文件夹无需切换到终端。官方文档推荐社区维护的Repomix Runner扩展从 VSCode Marketplace 搜索安装即可仓库中不包含该扩展源码它由社区独立维护。该扩展的核心能力一键打包任意文件夹在资源管理器中右键即可触发免去手敲命令文件 / 内容两种复制模式可选择把打包结果写成文件或直接把内容复制到剪贴板自动清理输出文件重复打包时自动处理旧的输出产物避免堆积兼容repomix.config.json自动读取项目根目录的 Repomix 配置文件沿用你的 include/ignore、输出风格等自定义设置配置文件说明见 configuration 指南。方式五浏览器扩展Chrome / Firefox浏览器扩展面向在 GitHub 网页上即用即走的场景安装后任何 GitHub 仓库页面都会出现一个Repomix按钮点击即可将该仓库交给 Repomix 处理无需本地安装任何 CLI。Chrome在 Chrome Web Store 搜索 Repomix 安装Firefox在 Firefox Add-ons 商店搜索 Repomix 安装。从仓库源码可以印证其实现原理browser/package.json 基于WXT框架构建支持 Chrome、Firefox、Edge 三端功能通过内容脚本Content Script注入实现——browser/entrypoints/content.ts 负责向 GitHub 仓库页面注入按钮browser/utils/github-navigation.ts 负责定位仓库页面的操作栏区域并跳转点击按钮即把当前仓库转交 Repomix 处理。扩展声明权限最小化仅访问 github.com不收集数据具体开发/构建方式npm run build:chrome等见 browser/README.md。官方文档注明更多功能即将推出当前版本聚焦于一键跳转的核心体验。安装后自检验证 CLI 是否就绪无论采用上述哪种方式安装完成后都建议立即执行两条命令确认环境可用repomix --version repomix --help这两条命令的行为可以从源码层面确认repomix --version走的是 src/cli/actions/versionAction.ts 中的runVersionAction它会调用 src/core/file/packageJsonParse.ts 的getVersion()从仓库根目录package.json的version字段读取版本号并打印当前仓库版本为1.18.0。若版本读取失败会降级输出unknown并打印警告日志。repomix --help由 src/cli/cliRun.ts 中的commander程序定义输出帮助信息会按Basic / CLI Input-Output / Repomix Output / File Selection / Remote Repository / Configuration / Security / Token Count / MCP / Watch Mode等分组展示全部参数包括--style、--output、--include、--ignore、--remote、--token-budget等核心选项的默认值与说明完整参数参考见 command-line-options 指南。另外值得注意的一个细节CLI 内置了语义纠错能力。在 src/cli/cliRun.ts 的semanticSuggestionMap中当用户输入了语义相近但非法的参数时如把--ignore写成--exclude、把--output写成--save、把--compress写成--minimize程序会提示 Did you mean: ...? 建议正确选项。这是安装后自检时最容易感受到的贴心设计之一。下一步安装之后怎么用安装并验证通过后建议按以下路径继续上手阅读 基本用法指南了解最常用的repomix、repomix --include、repomix --ignore、repomix --style markdown等实战命令阅读 配置指南通过repomix.config.json固化打包规则配合 VS Code 扩展可开箱即用阅读 命令行选项参考掌握--remote远程仓库、--token-budgetToken 预算护栏、--mcpMCP 服务器模式、-w/--watch监听模式自动重打包等高级能力。总结一下选择建议临时试用选 npx日常高频选全局安装CI 或免环境选 DockerIDE 内操作选 VS Code 扩展纯网页浏览选浏览器扩展——六种方式覆盖了从零体验到工程化接入的全部场景且每种方式的系统要求Node.js ≥ 22、远程场景需 Git与官方文档、仓库配置完全一致可按需放心选用。【免费下载链接】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），仅供参考