by yvgude · yvgude/lean-ctx
A Rust tool that aggressively prunes context — drops dead imports, trims comments, compresses logs — before sending it to the agent.
lean-ctx is for the cost-conscious: it sits between you and the agent harness, applying token-saving transforms to outgoing context. Works across Claude Code, Codex, Cursor.
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"lean-ctx-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/yvgude/lean-ctx"
],
"_inferred": true
}
}
}Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.
{
"mcpServers": {
"lean-ctx-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/yvgude/lean-ctx"
],
"_inferred": true
}
}
}Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.
{
"mcpServers": {
"lean-ctx-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/yvgude/lean-ctx"
],
"_inferred": true
}
}
}Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".
{
"mcpServers": {
"lean-ctx-skill": {
"command": "git",
"args": [
"clone",
"https://github.com/yvgude/lean-ctx"
],
"_inferred": true
}
}
}Same shape as Claude Desktop. Restart Windsurf to pick up changes.
{
"mcpServers": [
{
"name": "lean-ctx-skill",
"command": "git",
"args": [
"clone",
"https://github.com/yvgude/lean-ctx"
]
}
]
}Continue uses an array of server objects rather than a map.
{
"context_servers": {
"lean-ctx-skill": {
"command": {
"path": "git",
"args": [
"clone",
"https://github.com/yvgude/lean-ctx"
]
}
}
}
}Add to context_servers. Zed hot-reloads on save.
claude mcp add lean-ctx-skill -- git clone https://github.com/yvgude/lean-ctxOne-liner. Verify with claude mcp list. Remove with claude mcp remove.
When to use: Your bills are climbing and you suspect context bloat.
Outcome: Lower bills with same task success.
Watch token graphs while lean-ctx prunes
| Tool | Inputs | When to call | Cost |
|---|---|---|---|
| prefilter | (see docs) | Runs over outgoing context | 1 call |
Agent missing contextLower aggressiveness; whitelist files that matter
| Alternative | When to use it instead | Tradeoff |
|---|---|---|
| context-mode | You want sandboxed tool output | Different layer |