<file path="src/index.ts">
import { repomix } from 'repomix';
</file>

npx repomix@latest

# 使用 npm 安装
npm install -g repomix

# 使用 yarn 安装
yarn global add repomix

# 使用 bun 安装
bun add -g repomix

# 使用 Homebrew 安装（macOS/Linux）
brew install repomix

repomix

repomix

repomix path/to/directory

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

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

# 直接使用 URL
repomix --remote https://github.com/yamadashy/repomix

# 使用 GitHub 简写
repomix --remote yamadashy/repomix

# 指定分支
repomix --remote https://github.com/yamadashy/repomix --remote-branch main

# 指定提交哈希
repomix --remote https://github.com/yamadashy/repomix --remote-branch 935b695

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

# 使用 git 获取已跟踪的文件
git ls-files "*.ts" | repomix --stdin

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

# 使用 fzf 交互式选择文件
find . -name "*.ts" -type f | fzf -m | repomix --stdin

# 包含默认 50 条提交记录
repomix --include-logs

# 指定提交数量
repomix --include-logs --include-logs-count 10

# 同时包含 diff
repomix --include-logs --include-diffs

repomix --compress

# 远程仓库也支持压缩
repomix --remote yamadashy/repomix --compress

repomix --init

# 生成全局配置，作为本地配置缺失时的兜底
repomix --init --global

{
  "$schema": "https://repomix.com/schemas/latest/schema.json",
  "output": {
    "filePath": "repomix-output.xml",
    "style": "xml",
    "compress": false,
    "fileSummary": true,
    "directoryStructure": true,
    "removeComments": false
  },
  "include": ["**/*"],
  "ignore": {
    "useGitignore": true,
    "useDefaultPatterns": true,
    "customPatterns": ["**/*.log", "tmp/"]
  },
  "security": {
    "enableSecurityCheck": true
  },
  "tokenCount": {
    "encoding": "o200k_base"
  }
}

{
  "include": ["src/**/*.ts", "tests/**/*.ts", "**/*.md"],
  "ignore": {
    "customPatterns": ["**/*.test.ts", "**/tmp/**", "**/coverage/**"]
  }
}

repomix --compress --include-logs --include-logs-count 20

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/checkout@v4

      - name: Pack repository with Repomix
        uses: yamadashy/repomix/.github/actions/repomix@main
        with:
          output: repomix-output.xml
          style: xml

      - name: Upload Repomix output
        uses: actions/upload-artifact@v4
        with:
          name: repomix-output.xml
          path: repomix-output.xml
          retention-days: 30

- name: Pack repository with Repomix
  uses: yamadashy/repomix/.github/actions/repomix@main
  with:
    directories: src tests
    include: "**/*.ts,**/*.md"
    ignore: "**/*.test.ts"
    output: repomix-output.txt
    compress: true

- name: Upload Repomix output
  uses: actions/upload-artifact@v4
  with:
    name: repomix-output
    path: repomix-output.txt

npm install repomix

import { runCli, type CliOptions } from 'repomix';

async function packProject() {
  const options = {
    output: 'output.xml',
    style: 'xml',
    compress: true,
    quiet: true
  } as CliOptions;
  
  const result = await runCli(['.'], process.cwd(), options);
  return result.packResult;
}

import { runCli, type CliOptions } from 'repomix';

async function processRemoteRepo(repoUrl) {
  const options = {
    remote: repoUrl,
    output: 'output.xml',
    compress: true
  } as CliOptions;
  
  return await runCli(['.'], process.cwd(), options);
}

import { searchFiles, collectFiles, processFiles, TokenCounter } from 'repomix';

async function analyzeFiles(directory) {
  const { filePaths } = await searchFiles(directory, { /* config */ });
  const rawFiles = await collectFiles(filePaths, directory);
  const processedFiles = await processFiles(rawFiles, { /* config */ });
  
  const tokenCounter = new TokenCounter('o200k_base');
  
  return processedFiles.map(file => ({
    path: file.path,
    tokens: tokenCounter.countTokens(file.content)
  }));
}

repomix --mcp

claude mcp add repomix -- npx -y repomix --mcp

# 限制在当前工作目录内
repomix --mcp --sandbox

# 限制在指定目录内
repomix --mcp --sandbox path/to/project

{
  "security": {
    "enableSecurityCheck": false
  }
}

repomix --no-security-check

<file_summary>
此文件是整个代码库的合并表示形式，供 AI 处理和上下文分析使用。
文件数量: 42
总 token 数: 52,340
</file_summary>
<directory_structure>
src/
  index.ts
  utils/
    helper.ts
</directory_structure>
<files>
<file path="src/index.ts">
import { repomix } from 'repomix';
</file>
</files>
<git_logs>
<git_log_commit>
<date>2026-04-10 00:47:19 +0900</date>
<message>feat(cli): Add --include-logs option</message>
<files>
  src/index.ts
</files>
</git_log_commit>
</git_logs>

# File Summary
（元数据与 AI 指令）

# Directory Structure
```
src/
  index.ts
  utils/
    helper.ts
```

# Files
## File: src/index.ts
```typescript
import { repomix } from 'repomix';
```

# Git Logs
## 提交：2026-04-10 00:47:19 +0900
**消息：** feat(cli): Add --include-logs option
**文件：**
- src/index.ts

{
  "fileSummary": {
    "generationHeader": "此文件是使用 Repomix 将整个代码库合并到单个文档中的表示形式。",
    "fileCount": 42,
    "totalTokens": 52340
  },
  "directoryStructure": "src/\n  index.ts\n  utils/\n    helper.ts",
  "files": {
    "src/index.ts": "import { repomix } from 'repomix';"
  }
}