Repomix 与 GitHub Actions 集成实战在 CI 中自动打包代码库供 AI 分析【免费下载链接】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在持续集成、代码审查或为 LLM 工具准备代码库的场景中将整个仓库打包成单个 AI 友好文件是一项高频需求。Repomix 官方提供了一等公民的 GitHub Actions 集成.github/actions/repomix/action.yml让你只需在工作流 YAML 中声明一个 step即可完成仓库打包、格式定制、多目录与压缩处理并将产物上传为 artifact 供后续流程或人工下载。读完本文你将掌握 Repomix Action 的全部输入输出参数、真实仓库中的完整工作流写法以及底层 composite action 的执行原理可直接复制到自己的 CI 管道中使用。Repomix Action 是什么一个开箱即用的 composite actionRepomix 的 GitHub Action 位于仓库 .github/actions/repomix/action.yml是一个composite action在runs.using: composite下定义意味着它内部封装了完整的执行步骤使用方无需关心 Node.js 环境准备与 npm 安装细节。从其源码可以清楚地看到整个执行管线由 4 个步骤组成Setup Node.js通过actions/setup-node安装指定版本的 Node.js默认24可通过node-version输入覆盖Install project dependencies若工作区存在package.json先执行npm install这是为了让repomix.config.ts这类基于本地源码的配置文件能够正常 import 依赖Install Repomix执行npm install --global repomix${REPOMIX_VERSION}全局安装 CLI默认安装latest可用repomix-version固定版本Run Repomix将各输入参数拼装为 CLI 参数并执行repomix最后把输出文件路径写入GITHUB_OUTPUT供后续步骤通过steps.id.outputs.output_file读取。引用 Action 的完整语法为- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml基础用法把仓库打包成单个文件在 workflow 中只需一个 step即可将当前仓库默认当前目录.打包为repomix-output.xml- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml默认情况下输出格式为 XML、默认开启智能压缩compress: true这与 CLI 的行为一致CLI 默认输出文件即repomix-output.xml见 src/cli/cliRun.ts 中-o, --output与--style的默认值。控制输出格式XML / Markdown / JSON / Plain通过style参数可以切换输出格式。Repomix 支持四种格式其中 XML 为默认格式因为 XML 标签结构被各大主流 AI 厂商如 Claude、Gemini、GPT 系官方推荐用于提示词结构化解析与检索效率更高详见 output.md。Markdown 格式适合需要人工阅读的场景- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdownJSON 格式适合下游程序化解析、接入 API 或自动化管道- name: Pack repository with Repomix (JSON format) uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.json style: jsonstyle的合法取值为xml、markdown、json、plain与 CLI 的--style选项一一对应CLI 源码中该选项描述为xml, markdown, json, or plain见 src/cli/cliRun.ts。打包多个目录并启用压缩当仓库包含多个需要单独打包的目录或需要对文件做精细的包含/排除控制时可以组合使用directories、include、ignore与compress- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: directories: src tests include: **/*.ts,**/*.md ignore: **/*.test.ts output: repomix-output.xml compress: true各参数含义如下directories以空格分隔的目录列表默认为.对应 CLI 的位置参数include逗号分隔的 glob 包含模式只打包匹配的文件对应--includeignore逗号分隔的 glob 排除模式对应--ignorecompress是否启用智能压缩默认true对应--compress。开启后 Repomix 会使用 Tree-sitter 解析源码仅抽取类、函数、接口等核心结构大幅缩减 token 消耗。将打包产物上传为 Artifact打包文件生成后可以配合actions/upload-artifact将产物上传供后续 job 步骤使用或供开发者从 Actions 页面下载- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: directories: src output: repomix-output.xml compress: true - name: Upload Repomix output uses: actions/upload-artifactv7 with: name: repomix-output path: repomix-output.xml如果需要在上传前确认生成路径可以读取 Action 的输出- name: Pack repository with Repomix id: pack uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml - name: Show output path run: echo Generated file: ${{ steps.pack.outputs.output_file }}Action 输入参数完整参考下表完整列出了 Action 的全部 9 个输入参数比文档表格多出的node-version可在 .github/actions/repomix/action.yml 中确认NameDescriptionDefaultdirectories以空格分隔的待打包目录列表默认为当前目录..include逗号分隔的 glob 包含模式ignore逗号分隔的 glob 排除模式output输出文件相对路径repomix-output.xmlcompress是否启用智能压缩置为false可关闭truestyle输出格式xml、markdown、json、plainxmladditional-args直接透传给 repomix CLI 的额外原始参数repomix-version要安装的 npm 包版本或 taglatestnode-version使用的 Node.js 版本24Action 输出NameDescriptionoutput_file生成文件的路径即output的值完整工作流示例下面是一个开箱即用的完整 workflow覆盖workflow_dispatch手动触发、push与pull_request自动触发并在打包后上传 artifact 且设置 30 天保留期。该结构与仓库自用的 .github/workflows/pack-repository.yml 保持一致生产工作流中还额外声明了permissions: contents: read的最小权限原则name: Pack repository with Repomix on: workflow_dispatch: push: branches: [ main ] pull_request: branches: [ main ] jobs: pack-repo: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkoutv7 - name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml - name: Upload Repomix output uses: actions/upload-artifactv7 with: name: repomix-output.xml path: repomix-output.xml retention-days: 30源码级原理输入参数如何变成 CLI 命令从 .github/actions/repomix/action.yml 的实现可以看到参数拼接逻辑非常直接directories按空格切分为位置参数数组使用IFS Bash 数组正确处理含空格的路径include/ignore非空时分别追加--include/--ignorecompress为true时追加--compressstyle非空时追加--style始终追加--outputadditional-args非空时同样按空格切分后透传。也就是说additional-args是通往 CLI 全部能力的后门任何未被上述输入覆盖的 CLI 选项都可以通过它传入。例如在 CI 中为打包结果设置 token 预算守卫让输出超过模型上下文窗口时工作流以非零码失败可写为- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdown additional-args: --token-budget 200000 --no-file-summary其中--token-budget number是 CLI 专门为 CI/Agent 场景设计的守卫选项当打包产物超过 N 个 token 时以非零退出码失败产物仍会生成仅通过退出码发出超限信号其校验逻辑位于 src/cli/cliRun.ts。--no-file-summary则用于省略文件摘要段进一步压缩体积见 src/cli/cliRun.ts。同样地include/ignore/compress/style与 CLI 选项--include、--ignore、--compress、--style一一对应均可在 src/cli/cliRun.ts 中找到其定义与默认值Action 只是这些底层能力的薄封装。这意味着你在 command-line-options.md 中看到的所有输出控制选项--include-diffs、--include-logs、--split-output、--header-text、--parsable-style等都可以通过additional-args在 CI 中直接使用。实战进阶建议固定版本以获得可复现构建将repomix-version固定到具体版本如repomix-version: 0.2.30避免latest带来的不确定性必要时也可用node-version对齐项目要求的 Node.js 版本。最小权限原则参考仓库自身工作流声明permissions: contents: read并在 checkout 时使用persist-credentials: false。把打包纳入代码审查流可在pull_request触发时将产物上传为 artifact供人工或后续 AI 审查 job 消费也可在 review 类 job 中先actions/download-artifact再喂给 LLM 工具。用--token-budget做上下文窗口守卫配合additional-args使用在 CI 中及早发现打包结果超出目标模型上下文的问题。忽略敏感文件Action 的ignore支持 glob 排除建议在打包前排除密钥、环境变量文件等敏感内容CLI 默认还带有安全扫描enableSecurityCheck见 repomix.config.json可拦截 API Key、密码等敏感数据。可靠性验证Action 自身的 CI 测试Repomix 仓库用 .github/workflows/test-action.yml 对 Action 做了矩阵式回归测试在 Node.js 22 / 24 / 26 三个版本上分别执行 minimal、basic、full 三种用例覆盖了仅指定output的最小调用、指定directoriesincludecompress的基础调用以及同时使用directories、include、ignore、compress和additional-args: --no-file-summary的完整调用并上传产物验证输出。这从侧面验证了本文中所有参数组合均可在真实 CI 环境中正确运行你可以在自己的仓库中放心照搬。总结Repomix Action 将安装 CLI → 拼接参数 → 执行打包 → 暴露产物路径这一完整链路封装为一个声明式 step基础用法一行uses即可进阶用法通过 9 个输入参数覆盖目录选择、glob 过滤、智能压缩、四种输出格式、版本固定与任意 CLI 能力透传。配合actions/upload-artifact与--token-budget守卫你可以把仓库打包无缝嵌入 CI 管道、代码审查或 LLM 分析流程让每个 commit 都自动生成一份可供 AI 直接消费的代码快照。【免费下载链接】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 与 GitHub Actions 集成实战：在 CI 中自动打包代码库供 AI 分析
Repomix 与 GitHub Actions 集成实战在 CI 中自动打包代码库供 AI 分析【免费下载链接】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在持续集成、代码审查或为 LLM 工具准备代码库的场景中将整个仓库打包成单个 AI 友好文件是一项高频需求。Repomix 官方提供了一等公民的 GitHub Actions 集成.github/actions/repomix/action.yml让你只需在工作流 YAML 中声明一个 step即可完成仓库打包、格式定制、多目录与压缩处理并将产物上传为 artifact 供后续流程或人工下载。读完本文你将掌握 Repomix Action 的全部输入输出参数、真实仓库中的完整工作流写法以及底层 composite action 的执行原理可直接复制到自己的 CI 管道中使用。Repomix Action 是什么一个开箱即用的 composite actionRepomix 的 GitHub Action 位于仓库 .github/actions/repomix/action.yml是一个composite action在runs.using: composite下定义意味着它内部封装了完整的执行步骤使用方无需关心 Node.js 环境准备与 npm 安装细节。从其源码可以清楚地看到整个执行管线由 4 个步骤组成Setup Node.js通过actions/setup-node安装指定版本的 Node.js默认24可通过node-version输入覆盖Install project dependencies若工作区存在package.json先执行npm install这是为了让repomix.config.ts这类基于本地源码的配置文件能够正常 import 依赖Install Repomix执行npm install --global repomix${REPOMIX_VERSION}全局安装 CLI默认安装latest可用repomix-version固定版本Run Repomix将各输入参数拼装为 CLI 参数并执行repomix最后把输出文件路径写入GITHUB_OUTPUT供后续步骤通过steps.id.outputs.output_file读取。引用 Action 的完整语法为- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml基础用法把仓库打包成单个文件在 workflow 中只需一个 step即可将当前仓库默认当前目录.打包为repomix-output.xml- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml默认情况下输出格式为 XML、默认开启智能压缩compress: true这与 CLI 的行为一致CLI 默认输出文件即repomix-output.xml见 src/cli/cliRun.ts 中-o, --output与--style的默认值。控制输出格式XML / Markdown / JSON / Plain通过style参数可以切换输出格式。Repomix 支持四种格式其中 XML 为默认格式因为 XML 标签结构被各大主流 AI 厂商如 Claude、Gemini、GPT 系官方推荐用于提示词结构化解析与检索效率更高详见 output.md。Markdown 格式适合需要人工阅读的场景- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdownJSON 格式适合下游程序化解析、接入 API 或自动化管道- name: Pack repository with Repomix (JSON format) uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.json style: jsonstyle的合法取值为xml、markdown、json、plain与 CLI 的--style选项一一对应CLI 源码中该选项描述为xml, markdown, json, or plain见 src/cli/cliRun.ts。打包多个目录并启用压缩当仓库包含多个需要单独打包的目录或需要对文件做精细的包含/排除控制时可以组合使用directories、include、ignore与compress- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: directories: src tests include: **/*.ts,**/*.md ignore: **/*.test.ts output: repomix-output.xml compress: true各参数含义如下directories以空格分隔的目录列表默认为.对应 CLI 的位置参数include逗号分隔的 glob 包含模式只打包匹配的文件对应--includeignore逗号分隔的 glob 排除模式对应--ignorecompress是否启用智能压缩默认true对应--compress。开启后 Repomix 会使用 Tree-sitter 解析源码仅抽取类、函数、接口等核心结构大幅缩减 token 消耗。将打包产物上传为 Artifact打包文件生成后可以配合actions/upload-artifact将产物上传供后续 job 步骤使用或供开发者从 Actions 页面下载- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: directories: src output: repomix-output.xml compress: true - name: Upload Repomix output uses: actions/upload-artifactv7 with: name: repomix-output path: repomix-output.xml如果需要在上传前确认生成路径可以读取 Action 的输出- name: Pack repository with Repomix id: pack uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml - name: Show output path run: echo Generated file: ${{ steps.pack.outputs.output_file }}Action 输入参数完整参考下表完整列出了 Action 的全部 9 个输入参数比文档表格多出的node-version可在 .github/actions/repomix/action.yml 中确认NameDescriptionDefaultdirectories以空格分隔的待打包目录列表默认为当前目录..include逗号分隔的 glob 包含模式ignore逗号分隔的 glob 排除模式output输出文件相对路径repomix-output.xmlcompress是否启用智能压缩置为false可关闭truestyle输出格式xml、markdown、json、plainxmladditional-args直接透传给 repomix CLI 的额外原始参数repomix-version要安装的 npm 包版本或 taglatestnode-version使用的 Node.js 版本24Action 输出NameDescriptionoutput_file生成文件的路径即output的值完整工作流示例下面是一个开箱即用的完整 workflow覆盖workflow_dispatch手动触发、push与pull_request自动触发并在打包后上传 artifact 且设置 30 天保留期。该结构与仓库自用的 .github/workflows/pack-repository.yml 保持一致生产工作流中还额外声明了permissions: contents: read的最小权限原则name: Pack repository with Repomix on: workflow_dispatch: push: branches: [ main ] pull_request: branches: [ main ] jobs: pack-repo: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkoutv7 - name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml - name: Upload Repomix output uses: actions/upload-artifactv7 with: name: repomix-output.xml path: repomix-output.xml retention-days: 30源码级原理输入参数如何变成 CLI 命令从 .github/actions/repomix/action.yml 的实现可以看到参数拼接逻辑非常直接directories按空格切分为位置参数数组使用IFS Bash 数组正确处理含空格的路径include/ignore非空时分别追加--include/--ignorecompress为true时追加--compressstyle非空时追加--style始终追加--outputadditional-args非空时同样按空格切分后透传。也就是说additional-args是通往 CLI 全部能力的后门任何未被上述输入覆盖的 CLI 选项都可以通过它传入。例如在 CI 中为打包结果设置 token 预算守卫让输出超过模型上下文窗口时工作流以非零码失败可写为- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdown additional-args: --token-budget 200000 --no-file-summary其中--token-budget number是 CLI 专门为 CI/Agent 场景设计的守卫选项当打包产物超过 N 个 token 时以非零退出码失败产物仍会生成仅通过退出码发出超限信号其校验逻辑位于 src/cli/cliRun.ts。--no-file-summary则用于省略文件摘要段进一步压缩体积见 src/cli/cliRun.ts。同样地include/ignore/compress/style与 CLI 选项--include、--ignore、--compress、--style一一对应均可在 src/cli/cliRun.ts 中找到其定义与默认值Action 只是这些底层能力的薄封装。这意味着你在 command-line-options.md 中看到的所有输出控制选项--include-diffs、--include-logs、--split-output、--header-text、--parsable-style等都可以通过additional-args在 CI 中直接使用。实战进阶建议固定版本以获得可复现构建将repomix-version固定到具体版本如repomix-version: 0.2.30避免latest带来的不确定性必要时也可用node-version对齐项目要求的 Node.js 版本。最小权限原则参考仓库自身工作流声明permissions: contents: read并在 checkout 时使用persist-credentials: false。把打包纳入代码审查流可在pull_request触发时将产物上传为 artifact供人工或后续 AI 审查 job 消费也可在 review 类 job 中先actions/download-artifact再喂给 LLM 工具。用--token-budget做上下文窗口守卫配合additional-args使用在 CI 中及早发现打包结果超出目标模型上下文的问题。忽略敏感文件Action 的ignore支持 glob 排除建议在打包前排除密钥、环境变量文件等敏感内容CLI 默认还带有安全扫描enableSecurityCheck见 repomix.config.json可拦截 API Key、密码等敏感数据。可靠性验证Action 自身的 CI 测试Repomix 仓库用 .github/workflows/test-action.yml 对 Action 做了矩阵式回归测试在 Node.js 22 / 24 / 26 三个版本上分别执行 minimal、basic、full 三种用例覆盖了仅指定output的最小调用、指定directoriesincludecompress的基础调用以及同时使用directories、include、ignore、compress和additional-args: --no-file-summary的完整调用并上传产物验证输出。这从侧面验证了本文中所有参数组合均可在真实 CI 环境中正确运行你可以在自己的仓库中放心照搬。总结Repomix Action 将安装 CLI → 拼接参数 → 执行打包 → 暴露产物路径这一完整链路封装为一个声明式 step基础用法一行uses即可进阶用法通过 9 个输入参数覆盖目录选择、glob 过滤、智能压缩、四种输出格式、版本固定与任意 CLI 能力透传。配合actions/upload-artifact与--token-budget守卫你可以把仓库打包无缝嵌入 CI 管道、代码审查或 LLM 分析流程让每个 commit 都自动生成一份可供 AI 直接消费的代码快照。【免费下载链接】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），仅供参考