基本用法

快速開始

打包整個倉庫：

repomix

常見使用場景

打包指定目錄

repomix path/to/directory

包含特定文件

使用 glob 模式：

repomix --include "src/**/*.ts,**/*.md"

排除文件

repomix --ignore "**/*.log,tmp/"

處理遠端倉庫

# 使用 GitHub URL
repomix --remote https://github.com/user/repo

# 使用簡寫形式
repomix --remote user/repo

# 指定分支/標籤/提交
repomix --remote user/repo --remote-branch main
repomix --remote user/repo --remote-branch 935b695

文件列表輸入（stdin）

通過 stdin 傳遞文件路徑以獲得終極靈活性：

# 使用 find 命令
find src -name "*.ts" -type f | repomix --stdin

# 使用 git 獲取追蹤的文件
git ls-files "*.ts" | repomix --stdin

# 使用 ripgrep (rg) 查找文件
rg --files --type ts | repomix --stdin

# 使用 grep 查找包含特定內容的文件
grep -l "TODO" **/*.ts | repomix --stdin

# 使用 ripgrep 查找包含特定內容的文件
rg -l "TODO|FIXME" --type ts | repomix --stdin

# 使用 sharkdp/fd 查找文件
fd -e ts | repomix --stdin

# 使用 fzf 從所有文件中選擇
fzf -m | repomix --stdin

# 使用 fzf 進行互動式文件選擇
find . -name "*.ts" -type f | fzf -m | repomix --stdin

# 使用 ls 和 glob 模式
ls src/**/*.ts | repomix --stdin

# 從包含文件路徑的文件中讀取
cat file-list.txt | repomix --stdin

# 使用 echo 直接輸入
echo -e "src/index.ts\nsrc/utils.ts" | repomix --stdin

--stdin 選項允許您向 Repomix 傳遞文件路徑列表，在選擇要打包的文件時提供終極靈活性。

使用 --stdin 時，指定的文件實際上被添加到包含模式中。這意味著正常的包含和忽略行為仍然適用 - 通過 stdin 指定的文件如果匹配忽略模式仍會被排除。

NOTE

使用 --stdin 時，文件路徑可以是相對路徑或絕對路徑，Repomix 會自動處理路徑解析和去重。

程式碼壓縮

repomix --compress

# 您也可以將其用於遠端倉庫：
repomix --remote yamadashy/repomix --compress

權杖數量最佳化

了解程式碼庫的權杖分布對於最佳化AI互動至關重要。使用 --token-count-tree 選項可視化整個專案的權杖使用情況：

repomix --token-count-tree

這將顯示帶有權杖計數的程式碼庫層次結構視圖：

🔢 Token Count Tree:
────────────────────
└── src/ (70,925 tokens)
    ├── cli/ (12,714 tokens)
    │   ├── actions/ (7,546 tokens)
    │   └── reporters/ (990 tokens)
    └── core/ (41,600 tokens)
        ├── file/ (10,098 tokens)
        └── output/ (5,808 tokens)

您還可以設定最小權杖閾值來關注較大的檔案：

repomix --token-count-tree 1000  # 僅顯示擁有1000+權杖的檔案/目錄

這有助於您：

• 識別重權杖檔案 - 可能超出AI上下文限制的檔案
• 最佳化檔案選擇 - 使用 --include 和 --ignore 模式
• 規劃壓縮策略 - 針對最大貢獻者的策略
• 平衡內容與上下文 - 為AI分析準備程式碼時的平衡

輸出格式

XML（預設）

repomix --style xml

Markdown

repomix --style markdown

純文字

repomix --style plain

其他選項

移除註釋

repomix --remove-comments

顯示行號

repomix --output-show-line-numbers

複製到剪貼簿

repomix --copy

禁用安全檢查

repomix --no-security-check

配置

初始化配置文件：

repomix --init

更多詳細配置選項請參閱配置指南。