監視模式

Repomix 可以監視你的程式碼庫，並在檔案變更時自動重新打包。這能讓輸出檔案在你工作期間保持最新，當你想要將持續更新的快照提供給 AI 助理時非常方便。

用法

使用 -w（或 --watch）旗標啟動監視模式：

repomix --watch

Repomix 會先執行一次初始打包，接著持續執行並在每次變更時重新打包。你可以將監視模式與一般選項結合使用：

# 監視特定的一組檔案
repomix -w --include "src/**/*.ts"

# 使用自訂的輸出檔案與格式進行監視
repomix --watch -o output.md --style markdown

按下 Ctrl+C 即可停止監視。

運作方式

• 初始打包：Repomix 會先打包程式碼庫一次，然後回報它正在監視多少個檔案。
• 變更偵測：新增、變更與刪除檔案都會觸發重新打包。
• 防抖：短時間內密集的變更（例如切換分支或一次儲存大量檔案）會被合併處理。Repomix 會在最後一次變更後等待 300 ms 才重新打包，因此一連串的編輯只會產生一次重建。
• 時間戳記：每次重建後，Repomix 會印出一個時間戳記（Rebuilt at HH:MM:SS），讓你能夠得知輸出上次更新的時間。

被忽略的檔案

監視模式遵循與一般執行相同的忽略規則：.gitignore、.repomixignore、內建的預設模式（例如 node_modules 與 .git），以及你傳入的任何 --ignore 模式。被忽略的目錄不會被監視，這能讓監視模式在大型專案上保持高效率。

選項相容性

監視模式僅適用於本機目錄，因此無法與下列選項結合使用（無論你是在命令列上設定，還是在設定檔中設定）：

• --remote 或位置參數形式的遠端儲存庫 URL — 監視模式僅限本機
• --stdout 或 --stdin — 串流模式沒有可供更新的持續性輸出檔案
• --split-output
• --skill-generate
• --copy — 每次變更都重新打包會反覆覆寫剪貼簿

如果你將上述任一選項與 --watch 結合使用，Repomix 會結束並顯示說明該衝突的錯誤訊息。

相關資源

• 命令列選項 - 完整的 CLI 參考，包含 --watch
• 基本用法 - 其他執行 Repomix 的方式
• 設定 - 在設定檔中設定預設輸出選項