Repomix
Packs a repository into one LLM-ready file with token counts, code compression and secret filtering, also runs as an MCP server
Install
npx repomix@latestPacks the current folder into repomix-output.xml. For regular use there is npm install -g repomix and brew install repomix.
This is third-party code. Review the repository files before installing.
What it does
Repomix walks a project and combines the relevant files into one document you can hand to a model whole. It honors .gitignore and its own ignore rules, counts tokens per file and overall, and uses Secretlint to leave out files that look like credentials. The --compress option uses Tree-sitter to keep signatures and structure without implementations, cutting size. In MCP mode the agent packs a local folder or a remote repository itself and searches the output.
Who it is for. For developers who paste code into a model chat or want an agent to get a quick overview of another repository.
Good fit when
- You need to give a whole project to a long-context model
- You need to understand someone else's repository quickly
- You want to know how many tokens a codebase takes
Not a fit when
- The agent already works inside the project and reads files itself
- The project is too large even for compressed output
Example request
Pack the yamadashy/repomix repository and explain its architectureLimitations
Secret detection looks for known formats and does not guarantee sensitive data stays out of the output. Compression removes function bodies, so it does not suit tasks where logic matters. Requires Node.js or Docker.
How to disable. Run claude mcp remove repomix or uninstall the repomix plugins via /plugin. Remove the global package with npm uninstall -g repomix.
Security check
- Reads all project files and combines them into one document
- Can fetch remote repositories
README in short
The README starts with running via npx and global install through npm, yarn, bun or Homebrew. It then covers include and ignore rules, Tree-sitter compression, secret checks, Docker and the config file. A large section documents the MCP server and its tools, Claude Code plugins and a standalone skill for other agents. There is a web version at repomix.com. MIT licensed.
FAQ
What format is the output?
By default repomix-output.xml in the current folder; the output format is configurable.
Can I pack a repository without cloning it?
Yes, the CLI has a --remote flag that takes a repository URL, and the MCP server has a tool for that.
Related
A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review
Skills for real engineers by Matt Pocock
Skills For Real Engineers
Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture
Reference MCP servers
Model Context Protocol servers
Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything
Up-to-date, version-specific library docs and code examples in your agent's context, via MCP or a CLI plus skill