repomix

Repomix — Broad Codebase Context

When to invoke this skill

Invoke repomix before any task that requires whole-repository understanding:

• Writing specs or architecture docs that reference multiple directories
• 04-uiux planning stage (before IntentSpec, LayoutSpec, TokenSpec)
• Reviewing consistency across many files
• Answering "how does X work across the codebase" questions
• Onboarding to an unfamiliar codebase

Do not use for single-file edits, simple bug fixes, or tasks where you already have the relevant files open.

---

CLI usage (primary method)

# Pack current directory to XML (AI-optimized, default)
repomix

# Pack to markdown (human-readable)
repomix --style markdown -o repomix-output/summary.md

# Pack with compression (Tree-sitter, ~70% fewer tokens)
repomix --compress

# Pack remote repo
repomix --remote user/repo
repomix --remote user/repo --remote-branch main -o output.xml

# Use a config file
repomix --config repomix.config.json

---

MCP tools (optional — only when repomix is a persistent MCP server)

mcporter call repomix.* fails with "Unknown MCP server" unless repomix is registered in Claude Code's MCP settings as a persistent server (autoStart: true). By default it is not — use CLI above instead.

If repomix IS configured as a persistent MCP server (via settings.json), these tools are available:

Tool	Use case
pack_codebase	Pack a local directory — returns outputFilePath, use that not outputId
pack_remote_repository	Pack a GitHub repo by URL or user/repo shorthand
grep_repomix_output	Search packed output (persistent server only)

---

Config file format

Create repomix.config.json in the project root:

{
  "output": {
    "filePath": "repomix-output/repo.xml",
    "style": "xml",
    "compress": false,
    "removeComments": false,
    "showLineNumbers": false,
    "fileSummary": true,
    "directoryStructure": true
  },
  "ignore": {
    "useGitignore": true,
    "useDotIgnore": true,
    "customPatterns": ["repomix-output/**", "*.lock", "dist/**", "node_modules/**"]
  },
  "tokenCount": {
    "encoding": "o200k_base"
  }
}