在 GitHub Actions 中使用 Repomix 自动化代码库打包完整实践指南【免费下载链接】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 是用于将整个代码库打包成单一、对 LLM 友好的文件的工具而 GitHub Actions 则能把这个打包过程变成 CI 流水线中的自动化环节。本文以 Repomix 官方 GitHub Actions 复合操作为核心讲解如何在工作流中一键生成repomix-output.xml覆盖输出格式切换、目录筛选、智能压缩、产物上传与全部输入参数并结合仓库内的 Action 定义源码与 CLI 实现深入解释每个参数在底层是如何被解析和执行的。为什么要在 CI 中集成 Repomix当仓库规模变大后把整个代码库喂给 Claude、ChatGPT、Gemini 等 LLM 工具前往往需要先手动运行repomix命令生成打包文件。将这一步放进 GitHub Actions 的好处非常直接AI 分析自动化每次代码变更后自动生成最新、可复现的代码库快照CI 集成把打包产物作为后续步骤如代码审查、文档生成的输入产物留存通过 Artifact 机制让团队成员随时下载打包文件代码审查辅助为 PR 场景生成当前分支代码 vs 主分支代码的可读摘要辅助人工审查。在 Repomix 仓库中这个 Action 本身就是一个成熟的复合 Action 实现官方也用它对自己的仓库做持续打包见 .github/workflows/pack-repository.yml。基本使用一条 step 完成打包在 workflow YAML 中新增一个 step 即可把仓库打包为 XML 文件- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xmluses指向 Repomix 仓库内的复合 Actioncomposite actionmain表示跟踪主分支最新版本正式使用时建议锁定到具体 tag 以提升可复现性output指定打包文件的相对路径默认值就是repomix-output.xml因此即使不写该参数也能工作。Action 内部会依次执行通过actions/setup-node配置 Node.js默认版本 24→ 若工作区存在package.json则先执行npm install确保repomix.config.ts可以导入本地源码→ 全局安装repomixrepomix-version→ 运行repomix并组装参数。这些步骤都定义在 .github/actions/repomix/action.yml 中。切换输出格式style 参数style参数决定输出格式默认值为xml可选值为xml、markdown、json、plain。生成 Markdown 格式- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdown生成 JSON 格式- name: Pack repository with Repomix (JSON format) uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.json style: json默认输出文件名与格式是配套的在 src/config/configSchema.ts 的defaultFilePathMap中xml → repomix-output.xml、markdown → repomix-output.md、plain → repomix-output.txt、json → repomix-output.json每种风格都有对应的默认文件名。从源码可见style在 CLI 解析时会被统一转为小写后写入配置见 src/cli/actions/defaultAction.ts 中的buildCliConfig因此大小写不敏感。多目录打包、include/ignore 与智能压缩一次打包可以覆盖多个目录并通过 glob 模式精确控制包含与排除范围还能开启智能压缩smart compression大幅减小输出体积- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: directories: src tests include: **/*.ts,**/*.md ignore: **/*.test.ts output: repomix-output.txt compress: true参数含义与约束directories空格分隔的目录列表不填时默认打包整个仓库.include逗号分隔的包含 glob 模式例如**/*.ts只保留 TypeScript 文件传入后对应 CLI 的--includeignore逗号分隔的排除 glob 模式例如排除全部测试文件**/*.test.ts对应 CLI 的--ignorecompress布尔值是否启用智能压缩对应 CLI 的--compress。从 .github/actions/repomix/action.yml 的实现看directories会被IFS read -r -a ARGS按空格安全拆分成数组include/ignore只在非空时才追加--include/--ignore参数compress仅在值为true时追加--compress最终以repomix ${ARGS[]}的方式执行。这种仅非空才传参的策略保证了 Action 与 CLI 参数语义完全一致。提示在配置层面include/ignore最终会进入repomix.config.json中的include数组与ignore.customPatterns数组示例见仓库根目录的 repomix.config.json因此 Action 参数与配置文件可以互相配合、按需覆盖。将打包产物上传为 Artifact打包文件默认落在工作区想要供后续步骤使用或供人下载可以配合actions/upload-artifact- 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 是复合 Action打包后的文件就留在工作区中后续任意 step 都可以直接通过path引用upload-artifact则把文件存入 Artifact可设置retention-days控制保留天数。Action 输入参数一览下表完整列出 Action 的全部输入以 .github/actions/repomix/action.yml 为准名称说明默认值directories要打包的目录列表空格分隔.include要包含的 glob 模式逗号分隔ignore要排除的 glob 模式逗号分隔output输出文件路径repomix-output.xmlstyle输出风格xml、markdown、json、plainxmlcompress是否启用智能压缩trueadditional-args透传给 repomix CLI 的额外原始参数repomix-version要安装的 npm 包版本latestnode-version使用的 Node.js 版本24值得留意两点compress的默认值Action 层默认开启压缩true而 CLI 层默认compress为false见 src/config/configSchema.ts 的repomixConfigDefaultSchema。原因在于 Action 的定位是尽量产出小文件与命令行默认行为并不矛盾使用时按需显式声明即可additional-args是万能扩展口任何 CLI 参数如--no-file-summary、--include-empty-directories、--top-files-len 3等都可以通过它原样透传。Action 内部会按空格拆分后追加到参数数组末尾例如additional-args: --no-file-summary最终执行repomix ... --no-file-summary。Action 输出Action 对外暴露一个输出变量便于后续 step 引用名称说明output_file生成的输出文件路径该值由 Action 在repomix执行结束后通过echo output_file${INPUT_OUTPUT} $GITHUB_OUTPUT写入供后续 step 用steps.step-id.outputs.output_file读取。完整工作流示例一个同时覆盖手动触发、push 与 PR 场景的完整工作流如下源自 .github/workflows/pack-repository.ymlname: 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进阶用法仓库内部的 .github/workflows/test-action.yml 展示了对该 Action 做矩阵测试的方式——在 Node.js 22/24/26 三种版本下分别以最小参数仅 output基础参数directories include compress完整参数多目录 include/ignore additional-args三档调用 Action并上传结果。这个工作流本身就是很好的参考模板你可以照搬它的矩阵结构在多个 Node 版本上验证自己的打包配置。底层原理Action 参数如何变成 CLI 参数把 Action 的输入映射到repomix命令链路非常清晰Action 声明层.github/actions/repomix/action.ymlinputs定义全部入参及默认值runs.steps定义执行逻辑参数组装层复合 Action 内的 bash 脚本把INPUT_DIRECTORIES、INPUT_INCLUDE、INPUT_IGNORE、INPUT_COMPRESS、INPUT_STYLE、INPUT_OUTPUT、INPUT_ADDITIONAL_ARGS按规则拼成参数数组然后执行repomix ${ARGS[]}CLI 解析层src/cli/actions/defaultAction.tsbuildCliConfig将--include、--ignore、--style、--output、--compress等选项映射进 Repomix 配置对象其中--include/--ignore通过splitPatterns拆分成数组--style转为小写后写入output.style配置合并层最终配置由默认配置 配置文件 CLI 配置三级合并而成mergeConfigsCLI 参数优先级最高。这也解释了为什么 Action 中出现的参数名include、ignore、style、compress与repomix命令行参数保持一致——它们走的是同一条配置通路你在本地 CLI 上验证过的任何组合都可以原样搬进 Action 的with:里。小结通过 Repomix 官方 GitHub Actions你可以把为 LLM 打包代码库这一重复劳动完全自动化style控制输出格式、directories/include/ignore精确圈定打包范围、compress压缩体积、additional-args透传任意 CLI 选项、output_file与upload-artifact打通产物消费链路。整套配置以 .github/actions/repomix/action.yml 为事实依据配合 .github/workflows/pack-repository.yml 与 .github/workflows/test-action.yml 两个真实工作流即可快速在自己的 CI 中落地。【免费下载链接】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），仅供参考