ashlr-plugin: replace Claude Code's built-in tools with 40 leaner MCP alternatives

Claude Code's default tools — Read, Grep, Edit, Bash — are functional but not lean. A full file read returns the whole file even when the agent needed twenty lines of it. ashlr-plugin replaces those built-ins with 40 MCP equivalents (ashlr__read, ashlr__edit, and so on) that apply truncation, diff-only responses, and codebase-aware compression before anything hits the context window.

What It Does

The authors benchmark the compression at 57% fewer tokens returned across real codebases — 62% on TypeScript, 65% on Python, 44% on Rust. Beyond the slimmer reads, the plugin adds capabilities the defaults don't have: GitHub issue and PR read-write, SQLite/Postgres querying, background long-running command management, and a genome layer — auto-maintained codebase documentation that sharpens grep calls over time.

It works across Claude Code, Codex, Cursor, Cline, Claude Desktop, and any MCP-compatible host. The free tier covers all 40 core tools; a $12/mo Pro tier adds cloud sync features.

# Prereq: Bun >= 1.3
curl -fsSL https://bun.sh/install | bash

# Install the plugin
curl -fsSL https://plugin.ashlr.ai/install.sh | bash

# Or from inside Claude Code:
# /plugin marketplace add ashlrai/ashlr-plugin

When It Helps Most

The gains are sharpest on large codebases with fat files — TypeScript monorepos, Python modules that sprawl, anything where Claude burns tokens confirming what it already half-knows from prior context. Projects made up of many small files (configs, tight components) see less benefit because the baseline tool output is already short.

The GitHub integration earns its keep if you have agents that work across issues and PRs without needing a browser handoff. Same for the SQL layer on any project that has a database in the loop.

The Real Caveats

Security first: the primary install is curl -fsSL https://plugin.ashlr.ai/install.sh | bash — a script piped from a third-party domain, not from raw.githubusercontent.com. This is a well-known anti-pattern: a compromised or hijacked installer could execute arbitrary code on your machine. The safer path is git clone https://github.com/ashlrai/ashlr-plugin, review the source, then install locally. Or use /plugin marketplace add ashlrai/ashlr-plugin inside Claude Code, which routes through Claude's own marketplace instead of an external domain.

The 57% is a tool-output benchmark, not a total-session number. If most of your Claude bill comes from long conversation context or system prompts, ashlr-plugin won't touch those. The compression is also an average — projects with mostly short targeted reads will see less than the headline; projects with deeply nested large files will see more. Check your own tool-call output share before expecting headline numbers.

Credit

ashlr-plugin is by ashlrai, MIT-licensed, and actively maintained. Full source, docs, and benchmarks at github.com/ashlrai/ashlr-plugin.