ashlr__readLABSCO SUMMARY
The same work, with the bulky parts left out of the context window.
The maintainers put the cross-language saving at −57% against the built-in tools, measured on vercel/ai, pandas and tokio with a 95% confidence interval and a script you can run on your own repository. Treat that as their number, then check it on your code — the mechanism is plain enough either way: nothing here fetches less information, it just stops printing the parts the model was going to skip.
What it is
A tool set that stands in for a coding agent's high-volume built-ins. Large files come back as a compacted view plus a summary, greps route through a repository index when one exists, edits return a diff instead of the whole file, and shell output is compressed by command type.
What you get
- ashlr__read — head, tail and an LLM summary for large files, with line numbers kept on code
- ashlr__grep — retrieval against the repository genome when it exists, ripgrep with a summary when it does not
- ashlr__edit and ashlr__multi_edit — search and replace returning only the diff, with near-miss candidates when a match fails
- ashlr__edit_structural for AST-aware renames across files, with a shadowing guard and a dry run
- ashlr__bash with per-command summarizers for git log, git diff, ls, ps, tsc, package installs and test output
- ashlr__bash_start and its companions for starting, tailing, stopping and listing long-running commands
- ashlr__tree, ashlr__glob, ashlr__ls and ashlr__orient for finding your way around a codebase
- ashlr__sql, ashlr__http, ashlr__webfetch, ashlr__logs, ashlr__diff, ashlr__diff_semantic and ashlr__test
- ashlr__issue, ashlr__pr, ashlr__issue_create, ashlr__issue_close, ashlr__pr_comment and ashlr__pr_approve — no merge, close or delete
- ashlr__savings — session and lifetime token savings, broken down per tool
Requirements
Bun 1.3 or newer, installed before the plugin — check with bun --version. There is an install script for macOS and Linux and a PowerShell one for Windows. Claude Code additionally gets automatic redirects from the built-in tools, slash commands and a status line; Codex, Cline, Cursor, Claude Desktop, Goose and generic hosts get the tools and the accounting without those extras.
Setup effort
Follow the published steps
USE CASES
Reading a large source file without burning the context window
Get head, tail and a summary instead of the whole file, with line numbers intact.
Searching a repository the agent has not indexed
Query the genome when one exists, fall back to ripgrep with a summary when it does not.
Renaming a symbol across files
Do it AST-aware with a dry run first, and a guard against shadowed names.
Running a build or test suite and reading only what failed
Compress runner noise into one block per failure instead of pasting the whole log.
Kicking off something slow and checking back
Start the command in the background, then tail it and stop it from the same control plane.
Reviewing a pull request from the terminal
Read the PR and its issues, leave a comment, and approve — merges are deliberately not available.
Finding out whether any of this is working
Read the per-tool savings for the session and for all time.
32 tools
Listed in project docs. Your client may show a different list.
ashlr__grepashlr__editashlr__edit_structuralashlr__multi_editashlr__savingsashlr__bashashlr__bash_startashlr__sqlashlr__httpashlr__webfetchashlr__logsashlr__diffashlr__diff_semanticashlr__testashlr__treeashlr__globashlr__lsashlr__orientashlr__genome_proposeashlr__issueashlr__prashlr__issue_createashlr__issue_closeashlr__pr_commentashlr__pr_approveashlr__askashlr__pipeashlr__websearchashlr__task_listashlr__notebook_editashlr__writeBEFORE YOU INSTALL
What to know first
Tools you get
32 tools named in the project's documentation.
Requires
Bun ≥ 1.3
INSTALLATION
Connect your client
Server setup
Claude Code — macOS, Linux
Install Bun >= 1.3 first if missing: curl -fsSL https://bun.sh/install | bash (Windows: powershell -c "irm bun.sh/install.ps1 | iex")
curl -fsSL https://plugin.ashlr.ai/install.sh | bashWindows instead: irm https://raw.githubusercontent.com/ashlrai/ashlr-plugin/main/docs/install.ps1 | iex.
Inside Claude Code: /plugin marketplace add ashlrai/ashlr-plugin
Inside Claude Code: /plugin install ashlr@ashlr-marketplace
Inside Claude Code: /reload-plugins (or fully quit and restart Claude Code)
Verify with /ashlr-status, then run /ashlr-allow once so Claude Code stops prompting on every tool call
MCP Clients
Claude Code — Windows
irm https://raw.githubusercontent.com/ashlrai/ashlr-plugin/main/docs/install.ps1 | iexClaude Code — plugin
/plugin marketplace add ashlrai/ashlr-plugin
/plugin install ashlr@ashlr-marketplace
/reload-pluginsCodex
git clone https://github.com/ashlrai/ashlr-plugin
cd ashlr-plugin
bun install
codex plugin marketplace add ashlrai/ashlr-plugin
codex plugin add ashlr@ashlr-marketplace
bun run scripts/cli.ts codex-doctor --json