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将整个仓库打包为单个 AI 友好文件的 Repomix可以通过 GitHub Actions 官方复合 Action 无缝接入 CI/CD 流程实现代码库的自动打包、多格式输出与工件归档。本文以 Repomix 仓库中的 GitHub Actions 使用文档website/client/src/en/guide/github-actions.md为主体结合 src/config/configSchema.ts 等源码系统讲解 Action 的每个输入参数、底层实现原理与完整生产级 workflow 示例帮助你快速上手将 Repomix 自动化集成到持续集成、代码审查或 LLM 工具准备环节。为什么要在 GitHub Actions 中使用 RepomixRepomix 的核心能力是把整个代码库打包成一个 XML、Markdown、JSON 或纯文本文件方便直接喂给 Claude、ChatGPT、DeepSeek 等大语言模型进行分析。通过 GitHub Actions 自动化这一过程可以在以下场景发挥价值持续集成CI每次 push 或 pull_request 自动生成最新代码库的打包文件作为构建产物之一代码审查将打包后的代码文件上传为工件供人工或 AI 驱动的审查流程使用LLM 工具准备在发布或分析流水线中预先产出模型可直接消费的代码上下文文件。Action 本身基于yamadashy/repomix/.github/actions/repomixmain其内部会安装 npm 包并执行 Repomix CLI同时把常用 CLI 参数封装为结构化的with输入。基本用法一个 step 完成打包在 workflow 的 YAML 文件中添加如下 step即可把当前仓库默认目录.打包为 XML 文件- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml从源码看xml是 Repomix 的默认输出样式对应默认文件名repomix-output.xmlexport const repomixOutputStyleSchema v.picklist([xml, markdown, json, plain]); // ... export const defaultFilePathMap: RecordRepomixOutputStyle, string { xml: repomix-output.xml, markdown: repomix-output.md, plain: repomix-output.txt, json: repomix-output.json, } as const;以上代码位于 src/config/configSchema.ts。因此即使不显式声明styleAction 也会按xml样式生成repomix-output.xml。切换输出格式markdown 与 json通过style参数可以指定不同的输出格式默认xml- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdown- name: Pack repository with Repomix (JSON format) uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.json style: jsonstyle的合法取值在 src/config/configSchema.ts 中通过picklist严格约束为四种xml、markdown、json、plain。这意味着plain文本样式同样可用输出文件建议命名为repomix-output.txt。CLI 层面--style选项会经由 src/cli/actions/defaultAction.ts 中的buildCliConfig转为配置对象的output.style字段Action 的style参数本质上就是该 CLI 选项的封装。多目录打包与智能压缩Repomix 允许同时打包多个目录并通过 glob 模式控制包含与排除同时开启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.txt compress: true各参数含义如下directories以空格分隔的目录列表此处打包src与tests两个目录include以逗号分隔的 glob 包含模式仅保留 TypeScript 与 Markdown 文件ignore以逗号分隔的 glob 排除模式剔除测试文件compress开启智能压缩true启用。compress 的底层原理从源码看compress不是简单的文件瘦身而是基于 tree-sitter 的注释/空白内容压缩。处理顺序为removeComments → compress → truncateBase64 → removeEmptyLines → trim → showLineNumbers见 src/core/file/fileProcess.ts。在 src/core/file/fileProcessContent.ts 中可以看到当文件解析出的包含级别为compress时会调用 tree-sitter 解析器剔除注释与无关空白若文件语言不受支持、解析失败或触发 WASM 解析异常则回退为保留未压缩内容并记录日志if (effectiveLevel compress) { try { // tree-sitter 解析并压缩注释/空白 } catch { logger.trace(Could not compress ${rawFile.path}. Using uncompressed content.); } }另外src/core/file/fileProcess.ts 表明只有 compress 和 removeComments 这类 AST 级别的重处理才会被调度到 worker 线程执行体现了对性能的刻意设计。项目自身的压缩配置参考本仓库的 repomix.config.json 展示了压缩相关配置在配置文件中的形态{ output: { filePath: repomix-output.xml, style: xml, compress: false, removeComments: false, removeEmptyLines: false, truncateBase64: true } }注意配置文件中的默认compress为false见 src/config/configSchema.ts而 GitHub Actions 的compress参数默认是true两者默认值不同在 Action 中显式声明compress可获得确定的行为。将打包结果上传为 Artifact为了让后续 step 或人工能够下载打包文件可用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这里的name是工件在 GitHub Actions 界面中的展示名path指向 Repomix 生成的输出文件相对路径。Action 输入参数完整参考名称描述默认值directories要打包的目录列表以空格分隔.include要包含的 glob 模式以逗号分隔ignore要排除的 glob 模式以逗号分隔output输出文件路径repomix-output.xmlstyle输出样式xml、markdown、json、plainxmlcompress启用智能压缩trueadditional-args传给 repomix CLI 的额外参数repomix-version要安装的 npm 包版本latest要点说明directories默认打包整个仓库.对应 CLI 的目录位置参数include/ignore的逗号分隔格式会在 CLI 层经 src/shared/patternUtils.ts 的splitPatterns拆分为数组见 src/cli/actions/defaultAction.ts与命令行--include/--ignore行为一致additional-args提供了逃生舱任何未单独封装的 CLI 参数例如--remove-comments、--output-show-line-numbers、--no-file-summary等都可以原样透传具体可用参数可参考 src/cli/actions/defaultAction.ts 中buildCliConfig处理的全量选项repomix-version允许锁定 Repomix 版本避免latest带来的行为漂移适合对产物稳定性有要求的 CI 流水线。Action 输出名称描述output_file生成的输出文件路径output_file输出可在后续 step 中通过steps.step_id.outputs.output_file引用用于将生成文件路径动态传给上传步骤或其他消费者。完整 workflow 示例以下是一个生产可用的完整 workflow支持手动触发workflow_dispatch、push 与 pull_request 触发在ubuntu-latest上执行打包并上传带 30 天保留期的工件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实战建议固定版本将uses从main改为具体的版本 tag如v0.x.x并在repomix-version中指定相同版本保证 CI 结果可复现保留期retention-days: 30可避免工件永久占用仓库存储配额触发策略仅在main分支打包可减少无意义运行需要人工按需打包时使用workflow_dispatch。仓库 README.md 中同样收录了 GitHub Actions 的入门示例可与本文结合对照使用。小结通过yamadashy/repomix/.github/actions/repomixmain这个官方复合 ActionRepomix 的全部核心能力——多目录打包、glob 包含/排除、四种输出样式、tree-sitter 智能压缩——都可以在 GitHub Actions 中零脚本声明式使用。配合upload-artifact上传输出文件即可构建出代码提交 → 自动打包 → 供 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 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 友好文件的 Repomix可以通过 GitHub Actions 官方复合 Action 无缝接入 CI/CD 流程实现代码库的自动打包、多格式输出与工件归档。本文以 Repomix 仓库中的 GitHub Actions 使用文档website/client/src/en/guide/github-actions.md为主体结合 src/config/configSchema.ts 等源码系统讲解 Action 的每个输入参数、底层实现原理与完整生产级 workflow 示例帮助你快速上手将 Repomix 自动化集成到持续集成、代码审查或 LLM 工具准备环节。为什么要在 GitHub Actions 中使用 RepomixRepomix 的核心能力是把整个代码库打包成一个 XML、Markdown、JSON 或纯文本文件方便直接喂给 Claude、ChatGPT、DeepSeek 等大语言模型进行分析。通过 GitHub Actions 自动化这一过程可以在以下场景发挥价值持续集成CI每次 push 或 pull_request 自动生成最新代码库的打包文件作为构建产物之一代码审查将打包后的代码文件上传为工件供人工或 AI 驱动的审查流程使用LLM 工具准备在发布或分析流水线中预先产出模型可直接消费的代码上下文文件。Action 本身基于yamadashy/repomix/.github/actions/repomixmain其内部会安装 npm 包并执行 Repomix CLI同时把常用 CLI 参数封装为结构化的with输入。基本用法一个 step 完成打包在 workflow 的 YAML 文件中添加如下 step即可把当前仓库默认目录.打包为 XML 文件- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.xml从源码看xml是 Repomix 的默认输出样式对应默认文件名repomix-output.xmlexport const repomixOutputStyleSchema v.picklist([xml, markdown, json, plain]); // ... export const defaultFilePathMap: RecordRepomixOutputStyle, string { xml: repomix-output.xml, markdown: repomix-output.md, plain: repomix-output.txt, json: repomix-output.json, } as const;以上代码位于 src/config/configSchema.ts。因此即使不显式声明styleAction 也会按xml样式生成repomix-output.xml。切换输出格式markdown 与 json通过style参数可以指定不同的输出格式默认xml- name: Pack repository with Repomix uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.md style: markdown- name: Pack repository with Repomix (JSON format) uses: yamadashy/repomix/.github/actions/repomixmain with: output: repomix-output.json style: jsonstyle的合法取值在 src/config/configSchema.ts 中通过picklist严格约束为四种xml、markdown、json、plain。这意味着plain文本样式同样可用输出文件建议命名为repomix-output.txt。CLI 层面--style选项会经由 src/cli/actions/defaultAction.ts 中的buildCliConfig转为配置对象的output.style字段Action 的style参数本质上就是该 CLI 选项的封装。多目录打包与智能压缩Repomix 允许同时打包多个目录并通过 glob 模式控制包含与排除同时开启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.txt compress: true各参数含义如下directories以空格分隔的目录列表此处打包src与tests两个目录include以逗号分隔的 glob 包含模式仅保留 TypeScript 与 Markdown 文件ignore以逗号分隔的 glob 排除模式剔除测试文件compress开启智能压缩true启用。compress 的底层原理从源码看compress不是简单的文件瘦身而是基于 tree-sitter 的注释/空白内容压缩。处理顺序为removeComments → compress → truncateBase64 → removeEmptyLines → trim → showLineNumbers见 src/core/file/fileProcess.ts。在 src/core/file/fileProcessContent.ts 中可以看到当文件解析出的包含级别为compress时会调用 tree-sitter 解析器剔除注释与无关空白若文件语言不受支持、解析失败或触发 WASM 解析异常则回退为保留未压缩内容并记录日志if (effectiveLevel compress) { try { // tree-sitter 解析并压缩注释/空白 } catch { logger.trace(Could not compress ${rawFile.path}. Using uncompressed content.); } }另外src/core/file/fileProcess.ts 表明只有 compress 和 removeComments 这类 AST 级别的重处理才会被调度到 worker 线程执行体现了对性能的刻意设计。项目自身的压缩配置参考本仓库的 repomix.config.json 展示了压缩相关配置在配置文件中的形态{ output: { filePath: repomix-output.xml, style: xml, compress: false, removeComments: false, removeEmptyLines: false, truncateBase64: true } }注意配置文件中的默认compress为false见 src/config/configSchema.ts而 GitHub Actions 的compress参数默认是true两者默认值不同在 Action 中显式声明compress可获得确定的行为。将打包结果上传为 Artifact为了让后续 step 或人工能够下载打包文件可用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这里的name是工件在 GitHub Actions 界面中的展示名path指向 Repomix 生成的输出文件相对路径。Action 输入参数完整参考名称描述默认值directories要打包的目录列表以空格分隔.include要包含的 glob 模式以逗号分隔ignore要排除的 glob 模式以逗号分隔output输出文件路径repomix-output.xmlstyle输出样式xml、markdown、json、plainxmlcompress启用智能压缩trueadditional-args传给 repomix CLI 的额外参数repomix-version要安装的 npm 包版本latest要点说明directories默认打包整个仓库.对应 CLI 的目录位置参数include/ignore的逗号分隔格式会在 CLI 层经 src/shared/patternUtils.ts 的splitPatterns拆分为数组见 src/cli/actions/defaultAction.ts与命令行--include/--ignore行为一致additional-args提供了逃生舱任何未单独封装的 CLI 参数例如--remove-comments、--output-show-line-numbers、--no-file-summary等都可以原样透传具体可用参数可参考 src/cli/actions/defaultAction.ts 中buildCliConfig处理的全量选项repomix-version允许锁定 Repomix 版本避免latest带来的行为漂移适合对产物稳定性有要求的 CI 流水线。Action 输出名称描述output_file生成的输出文件路径output_file输出可在后续 step 中通过steps.step_id.outputs.output_file引用用于将生成文件路径动态传给上传步骤或其他消费者。完整 workflow 示例以下是一个生产可用的完整 workflow支持手动触发workflow_dispatch、push 与 pull_request 触发在ubuntu-latest上执行打包并上传带 30 天保留期的工件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实战建议固定版本将uses从main改为具体的版本 tag如v0.x.x并在repomix-version中指定相同版本保证 CI 结果可复现保留期retention-days: 30可避免工件永久占用仓库存储配额触发策略仅在main分支打包可减少无意义运行需要人工按需打包时使用workflow_dispatch。仓库 README.md 中同样收录了 GitHub Actions 的入门示例可与本文结合对照使用。小结通过yamadashy/repomix/.github/actions/repomixmain这个官方复合 ActionRepomix 的全部核心能力——多目录打包、glob 包含/排除、四种输出样式、tree-sitter 智能压缩——都可以在 GitHub Actions 中零脚本声明式使用。配合upload-artifact上传输出文件即可构建出代码提交 → 自动打包 → 供 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），仅供参考
