# Repomix

> Packs a local folder or a GitHub repository into one AI-friendly file your agent can read, search and analyze from the chat.

Repomix packs a whole codebase into a single AI-friendly file. Run as a local MCP server, it lets your agent pack a folder on your machine or a GitHub repository, then read and search the packed output, so you don't prepare or upload files by hand. It's an open-source community project by Kazuki Yamada (yamadashy).

What you can do with it
- Pack a local folder into one file, choosing what to include and ignore with glob patterns
- Pack a GitHub repository by URL or owner/repo, including a branch or commit
- Compress code with Tree-sitter, keeping signatures and structure while leaving out implementation details
- Search a packed output with regular expressions, or read it by line range
- Attach a Repomix output file you already have
- Turn a local codebase into a Claude Agent Skill, with a summary, the project structure and its files

How it connects
It runs on your machine with npx -y repomix --mcp, or with Docker (ghcr.io/yamadashy/repomix --mcp). There's no account or sign-in. Repomix respects .gitignore and uses Secretlint to leave out files that match known credential formats. Repomix also publishes its own Claude Code plugins (repomix-mcp, repomix-commands and repomix-explorer) in its marketplace, yamadashy/repomix.

Good to know
- By default the server can read any path your user account can, and packing a folder loads that folder's repomix.config file, which can run code.
- For code you don't trust, start it with --sandbox: its file tools stay inside one workspace folder, config files aren't loaded, and remote packing, skill generation and attaching outputs are turned off.
- Repomix describes its MCP server as experimental.

- Type: Plugin
- Made by: yamadashy
- Category: AI & agents
- Formats: Local MCP, Claude plugins
- Version: latest
- Website: https://repomix.com/
- Source: https://github.com/yamadashy/repomix
- Page: https://pluginboard.ai/plugins/repomix

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "-y",
        "repomix@1.18.1",
        "--mcp"
      ]
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22repomix%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22-y%22%2C%22repomix%401.18.1%22%2C%22--mcp%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"repomix","command":"npx","args":["-y","-y","repomix@1.18.1","--mcp"]}'
```

Copilot CLI:

```shell
copilot mcp add repomix -- npx -y -y repomix@1.18.1 --mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=repomix&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIi15IiwicmVwb21peEAxLjE4LjEiLCItLW1jcCJdfQ%3D%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "-y",
        "repomix@1.18.1",
        "--mcp"
      ]
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add repomix -- npx -y -y repomix@1.18.1 --mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add repomix -- npx -y -y repomix@1.18.1 --mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "-y",
        "repomix@1.18.1",
        "--mcp"
      ]
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add repomix npx -y -y repomix@1.18.1 --mcp
```

### OpenClaw

In a terminal: Run openclaw mcp add repomix --command npx, with --arg before each argument (-y -y repomix@1.18.1 --mcp) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add repomix -- npx -y -y repomix@1.18.1 --mcp
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "repomix": {
      "command": "npx",
      "args": [
        "-y",
        "-y",
        "repomix@1.18.1",
        "--mcp"
      ]
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).