repomix-estimateLABSCO SUMMARY
Estimate first is the whole point.
Packing a repository into a model's context is a move that either works or wastes the whole window, and you normally find out which after it is too late. Splitting the estimate from the retrieval turns that into a decision: check the token count, add an ignore pattern or compression, check again, then pull. The directory restriction is worth noting too — the server cannot read outside where it was started, which makes it safe to leave connected.
What it is
A wrapper around repomix that adds the step people usually skip: measuring first. One tool estimates how large the packed output will be, the other actually returns it, and both take the same parameters — so you can check the size, adjust the include patterns or turn on compression, and only then spend the context. Local paths and remote repository URLs both work.
What you get
repomix-estimatereports output size in KB or MB and an estimated token count, without returning the contentrepomixpacks the repository and returns the file contentsincludeandignoreglob patterns to keep tests, builds and vendor directories outcompressto cut the token count on a large repositorystyleto choosexml,markdownorplainoutputremoteto pack a repository URL you have not cloned
Requirements
Node and a build from the repository: npm install then npm run build, and point your client at dist/index.js — or add it in Claude Code with claude mcp add. No account and no key. File access is restricted to the directory the server was started from, so paths outside it are refused; output files are written to the system temporary directory and cleaned up after the contents are returned.
Setup effort
Build from source — git clone https://github.com/Aeolun/repomix-mcp.git
USE CASES
Deciding whether a repository will fit in context
Get the size and estimated token count before retrieving anything.
Giving the model a whole codebase to reason over
Pack it into one file once the estimate says it fits.
Trimming a large repo down to what matters
Include only the file types you care about and exclude tests and build output.
Reading a project you have not cloned
Pass the repository URL and pack it remotely.
2 tools
Listed in project docs. Your client may show a different list.
repomixBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
git clone https://github.com/Aeolun/repomix-mcp.git
cd repomix-mcp
npm install
npm run buildMCP Clients
Claude Code
claude mcp add --scope user repomix node <YOUR_PATH_TO_REPOMIX_MCP>/dist/index.jsClaude Desktop
{
"mcpServers": {
"repomix": {
"command": "node",
"args": [
"<YOUR_PATH_TO_REPOMIX_MCP>/dist/index.js"
]
}
}
}