Repomix 监听模式Watch Mode完全指南文件变更时自动重新打包代码库【免费下载链接】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 的监听模式Watch Mode会持续监视你的本地代码库并在文件发生新增、修改或删除时自动重新打包始终保持输出文件与当前工作区同步。本文将以 watch-mode.md 文档为骨架结合仓库源码watchAction.ts、watchIgnore.ts、cliRun.ts深入讲解其用法、防抖机制、忽略规则与选项兼容性帮助你把它接入边写代码边喂给 AI 助手的工作流。基本用法监听模式通过-w或--watch标志启动repomix --watch启动后Repomix 会先执行一次初始打包initial pack随后保持运行并监视文件变化每次检测到变更都会重新打包。在 cliRun.ts 中该选项被定义在独立的 Watch Mode 选项分组下命令行帮助信息为 Watch for file changes and automatically re-pack。监听模式可以与常规选项自由组合# 只监听特定文件集合 repomix -w --include src/**/*.ts # 自定义输出文件与格式 repomix --watch -o output.md --style markdown其中--include用于限定要打包/监听的文件范围cliRun.ts-o/--output指定输出文件路径默认repomix-output.xml--style可选用xml、markdown、json或plain默认xml详见 command-line-options.md。停止监听只需按下CtrlC。此外源码还注册了SIGTERM信号处理watchAction.ts因此在容器或脚本环境中通过kill发送 SIGTERM 也能触发同样的优雅退出流程。工作原理从事件到重建监听模式的运行流程由四个环节构成watchAction.ts初始打包启动时先调用核心pack()函数完成一次完整打包watchAction.ts随后打印Watching N files for changes... (CtrlC to stop)报告当前正在监视的文件数量。变更检测新增add、修改change、删除unlink三类事件都会触发重新打包watchAction.ts。注意监听目标是目录而非单个文件这样才能发现新创建的文件watchAction.ts。防抖Debouncing切换分支、批量保存等场景会在极短时间内产生大量事件Repomix 会将其合并处理——在最后一次变更后等待300 ms才执行重建于 watchAction.ts 定义为常量REBUILD_DEBOUNCE_MS。因此一连串编辑最终只触发一次打包避免反复写盘。时间戳每次重建完成后输出Rebuilt at HH:MM:SS时间戳让你知道输出文件何时刷新watchAction.ts。该时间戳使用toTimeString()生成确保 24 小时制格式在所有平台含非 ASCII 数字环境的系统上保持一致。除防抖外源码还实现了两层稳健性保障均被 watchAction.test.ts 中的测试用例覆盖重建守卫Rebuild guard通过isRebuilding/pendingRebuild标志确保同一时刻只有一个打包任务在运行若重建期间又有变更到达会将其排队并在当前打包结束后立即补跑watchAction.ts。对应测试 should not start a concurrent rebuild while one is in progress 验证了这一点。写入稳定阈值传给 chokidar 的awaitWriteFinish.stabilityThreshold 100 mswatchAction.ts要求文件大小在 100ms 内保持稳定才触发事件避免打包到写到一半的残缺文件。错误容忍文件监视器错误如EMFILE、EACCES与重建失败均只记录日志而不会让进程崩溃重建失败后后续变更仍会正常触发新的重建watchAction.ts。忽略规则与打包完全一致的边界监听模式遵循与普通运行完全相同的忽略规则watch-mode.md.gitignore中的模式.repomixignore中的模式内置默认模式例如node_modules、.git通过--ignore传入的自定义模式。关键在于被忽略的目录不会被监视。从源码看watchIgnore.ts 通过buildWatchIgnoreFilter构建了一个 chokidarignored谓词函数它复用了打包器packer的整套忽略解析逻辑默认模式、自定义模式、.git/info/exclude、.gitignore、.ignore/.repomixignore。这样做有两个直接收益避免资源耗尽chokidar 不会下潜进node_modules或 gitignored 的目录树防止在大型项目中打开过多文件描述符而触发EMFILE。该实现还专门为每个foo/**模式生成了对应的目录形态匹配器watchIgnore.ts让目录本身在第一步就被排除从而真正剪断 chokidar 的遍历。避免无效重建被忽略文件的变化不会触发打包节省 CPU 与磁盘 I/O。从技术实现细节看由于 chokidar v4 的ignored选项不再支持 glob 字符串源码改用minimatch逐一求值 glob 模式并配合 globby 的isGitIgnored/isIgnoredByIgnoreFiles处理.gitignore类文件watchIgnore.ts。多根目录场景下判断会逐个根进行检查某一根不匹配不会提前返回false避免嵌套或重叠监听根导致规则漏判watchIgnore.ts。选项兼容性哪些不能与 --watch 同用监听模式只面向本地目录因此在命令行或配置文件中对它设置下列任一选项都会导致 Repomix 以报错退出watch-mode.md不兼容选项原因--remote或位置参数形式的远程仓库 URL监听模式仅支持本地目录--stdout或--stdin流式模式没有可供刷新的持久输出文件--split-output拆分输出会产生编号文件被监听器重新拾取后造成循环--skill-generate监听模式不支持技能生成--copy每次变更都重新打包会反复覆盖剪贴板校验分两道关卡完成。第一道在 cliRun.ts 的validateWatchOptions它只检查 CLI 标志并在日志级别切换之前执行避免--quiet抑制错误信息第二道在 watchAction.ts它在合并后的配置上重新检查一遍——因为splitOutput、copyToClipboard、skillGenerate、stdout包括配置文件里output: -这种解析为 stdout 的写法都可以通过配置文件注入第一道关卡看不到这些值。这两道关卡均有测试覆盖冲突测试should throw when --watch is used with --remote 等见 watchAction.test.ts配置文件来源的冲突测试见同一文件的 L444-L537。所有错误信息都会明确点名--watch与冲突选项便于定位问题例如--watch cannot be used with --copy. Watch mode re-packs on every change, which would repeatedly overwrite the clipboard.优雅退出与进程生命周期监听模式是一个长驻进程其退出路径同样经过了细致设计watchAction.ts同时监听SIGINT与SIGTERM退出清理逻辑幂等——重复按CtrlC也只会关闭 watcher 一次对应测试 cleans up only once when the shutdown signal fires twice清理时会先关闭 watcher再等待正在进行的重建完成两者独立 try/catch任一失败都不会跳过另一个测试同时验证了退出期间到达的变更会被忽略、未触发的防抖定时器会被取消不会在关闭后继续打包watchAction.test.ts。相关资源命令行选项完整参考含 --watchRepomix 基本用法配置文件设置默认输出选项监听模式核心实现src/cli/actions/watchAction.ts监听忽略过滤器实现src/cli/actions/watch/watchIgnore.ts选项校验与路由分发src/cli/cliRun.ts单元测试tests/cli/actions/watchAction.test.ts【免费下载链接】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 监听模式（Watch Mode）完全指南：文件变更时自动重新打包代码库
Repomix 监听模式Watch Mode完全指南文件变更时自动重新打包代码库【免费下载链接】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 的监听模式Watch Mode会持续监视你的本地代码库并在文件发生新增、修改或删除时自动重新打包始终保持输出文件与当前工作区同步。本文将以 watch-mode.md 文档为骨架结合仓库源码watchAction.ts、watchIgnore.ts、cliRun.ts深入讲解其用法、防抖机制、忽略规则与选项兼容性帮助你把它接入边写代码边喂给 AI 助手的工作流。基本用法监听模式通过-w或--watch标志启动repomix --watch启动后Repomix 会先执行一次初始打包initial pack随后保持运行并监视文件变化每次检测到变更都会重新打包。在 cliRun.ts 中该选项被定义在独立的 Watch Mode 选项分组下命令行帮助信息为 Watch for file changes and automatically re-pack。监听模式可以与常规选项自由组合# 只监听特定文件集合 repomix -w --include src/**/*.ts # 自定义输出文件与格式 repomix --watch -o output.md --style markdown其中--include用于限定要打包/监听的文件范围cliRun.ts-o/--output指定输出文件路径默认repomix-output.xml--style可选用xml、markdown、json或plain默认xml详见 command-line-options.md。停止监听只需按下CtrlC。此外源码还注册了SIGTERM信号处理watchAction.ts因此在容器或脚本环境中通过kill发送 SIGTERM 也能触发同样的优雅退出流程。工作原理从事件到重建监听模式的运行流程由四个环节构成watchAction.ts初始打包启动时先调用核心pack()函数完成一次完整打包watchAction.ts随后打印Watching N files for changes... (CtrlC to stop)报告当前正在监视的文件数量。变更检测新增add、修改change、删除unlink三类事件都会触发重新打包watchAction.ts。注意监听目标是目录而非单个文件这样才能发现新创建的文件watchAction.ts。防抖Debouncing切换分支、批量保存等场景会在极短时间内产生大量事件Repomix 会将其合并处理——在最后一次变更后等待300 ms才执行重建于 watchAction.ts 定义为常量REBUILD_DEBOUNCE_MS。因此一连串编辑最终只触发一次打包避免反复写盘。时间戳每次重建完成后输出Rebuilt at HH:MM:SS时间戳让你知道输出文件何时刷新watchAction.ts。该时间戳使用toTimeString()生成确保 24 小时制格式在所有平台含非 ASCII 数字环境的系统上保持一致。除防抖外源码还实现了两层稳健性保障均被 watchAction.test.ts 中的测试用例覆盖重建守卫Rebuild guard通过isRebuilding/pendingRebuild标志确保同一时刻只有一个打包任务在运行若重建期间又有变更到达会将其排队并在当前打包结束后立即补跑watchAction.ts。对应测试 should not start a concurrent rebuild while one is in progress 验证了这一点。写入稳定阈值传给 chokidar 的awaitWriteFinish.stabilityThreshold 100 mswatchAction.ts要求文件大小在 100ms 内保持稳定才触发事件避免打包到写到一半的残缺文件。错误容忍文件监视器错误如EMFILE、EACCES与重建失败均只记录日志而不会让进程崩溃重建失败后后续变更仍会正常触发新的重建watchAction.ts。忽略规则与打包完全一致的边界监听模式遵循与普通运行完全相同的忽略规则watch-mode.md.gitignore中的模式.repomixignore中的模式内置默认模式例如node_modules、.git通过--ignore传入的自定义模式。关键在于被忽略的目录不会被监视。从源码看watchIgnore.ts 通过buildWatchIgnoreFilter构建了一个 chokidarignored谓词函数它复用了打包器packer的整套忽略解析逻辑默认模式、自定义模式、.git/info/exclude、.gitignore、.ignore/.repomixignore。这样做有两个直接收益避免资源耗尽chokidar 不会下潜进node_modules或 gitignored 的目录树防止在大型项目中打开过多文件描述符而触发EMFILE。该实现还专门为每个foo/**模式生成了对应的目录形态匹配器watchIgnore.ts让目录本身在第一步就被排除从而真正剪断 chokidar 的遍历。避免无效重建被忽略文件的变化不会触发打包节省 CPU 与磁盘 I/O。从技术实现细节看由于 chokidar v4 的ignored选项不再支持 glob 字符串源码改用minimatch逐一求值 glob 模式并配合 globby 的isGitIgnored/isIgnoredByIgnoreFiles处理.gitignore类文件watchIgnore.ts。多根目录场景下判断会逐个根进行检查某一根不匹配不会提前返回false避免嵌套或重叠监听根导致规则漏判watchIgnore.ts。选项兼容性哪些不能与 --watch 同用监听模式只面向本地目录因此在命令行或配置文件中对它设置下列任一选项都会导致 Repomix 以报错退出watch-mode.md不兼容选项原因--remote或位置参数形式的远程仓库 URL监听模式仅支持本地目录--stdout或--stdin流式模式没有可供刷新的持久输出文件--split-output拆分输出会产生编号文件被监听器重新拾取后造成循环--skill-generate监听模式不支持技能生成--copy每次变更都重新打包会反复覆盖剪贴板校验分两道关卡完成。第一道在 cliRun.ts 的validateWatchOptions它只检查 CLI 标志并在日志级别切换之前执行避免--quiet抑制错误信息第二道在 watchAction.ts它在合并后的配置上重新检查一遍——因为splitOutput、copyToClipboard、skillGenerate、stdout包括配置文件里output: -这种解析为 stdout 的写法都可以通过配置文件注入第一道关卡看不到这些值。这两道关卡均有测试覆盖冲突测试should throw when --watch is used with --remote 等见 watchAction.test.ts配置文件来源的冲突测试见同一文件的 L444-L537。所有错误信息都会明确点名--watch与冲突选项便于定位问题例如--watch cannot be used with --copy. Watch mode re-packs on every change, which would repeatedly overwrite the clipboard.优雅退出与进程生命周期监听模式是一个长驻进程其退出路径同样经过了细致设计watchAction.ts同时监听SIGINT与SIGTERM退出清理逻辑幂等——重复按CtrlC也只会关闭 watcher 一次对应测试 cleans up only once when the shutdown signal fires twice清理时会先关闭 watcher再等待正在进行的重建完成两者独立 try/catch任一失败都不会跳过另一个测试同时验证了退出期间到达的变更会被忽略、未触发的防抖定时器会被取消不会在关闭后继续打包watchAction.test.ts。相关资源命令行选项完整参考含 --watchRepomix 基本用法配置文件设置默认输出选项监听模式核心实现src/cli/actions/watchAction.ts监听忽略过滤器实现src/cli/actions/watch/watchIgnore.ts选项校验与路由分发src/cli/cliRun.ts单元测试tests/cli/actions/watchAction.test.ts【免费下载链接】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），仅供参考