26382a7ac6
CI / Clippy (push) Failing after 15m13s
CI / Test (ubuntu-latest) (push) Failing after 16m1s
CI / Test (macos-latest) (push) Has been cancelled
CI / Test (windows-latest) (push) Has been cancelled
CI / Build (no embeddings / no ORT) (push) Has been cancelled
CI / Format (push) Has been cancelled
CI / Cookbook (Node) (push) Has been cancelled
CI / Pi Extension (Node) (push) Has been cancelled
CI / Rust SDK (lean-ctx-client) (push) Has been cancelled
CI / Embed SDK (lean-ctx-sdk) (push) Has been cancelled
CI / Python SDK (leanctx) (push) Has been cancelled
CI / Hermes Plugin (Python) (push) Has been cancelled
CI / SDK Conformance Matrix (push) Has been cancelled
CI / Coverage (push) Has been cancelled
CI / cargo-deny (push) Has been cancelled
CI / Adversarial Safety (push) Has been cancelled
CI / Benchmarks (push) Has been cancelled
CI / Output-Quality Gate (eval A/B) (push) Has been cancelled
CI / Documentation (push) Has been cancelled
CI / CI Green (push) Has been cancelled
JetBrains Plugin / Actionlint (push) Has been cancelled
CodeQL / Analyze (actions) (push) Has been cancelled
CodeQL / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL / Analyze (rust) (push) Has been cancelled
JetBrains Plugin / Validation (push) Has been cancelled
JetBrains Plugin / Build (push) Has been cancelled
JetBrains Plugin / Test (push) Has been cancelled
Security Check / Security Scan (push) Has been cancelled
1.4 KiB
1.4 KiB
lean-ctx — Token Optimization
lean-ctx is configured as an MCP server. Use lean-ctx MCP tools instead of built-in tools:
| Built-in | Use instead | Why |
|---|---|---|
| Read / cat / head | ctx_read |
Session caching, 6 compression modes, re-reads cost ~13 tokens |
| Bash (shell commands) | ctx_shell |
Pattern-based compression for git, npm, cargo, docker, tsc |
| Grep / rg | ctx_search |
Compact context, token-efficient results |
| ls / find | ctx_tree |
Compact directory maps with file counts |
For shell commands that don't have MCP equivalents, prefix with lean-ctx -c:
lean-ctx -c git status # compressed output
lean-ctx -c cargo test # compressed output
lean-ctx -c npm install # compressed output
ctx_read Modes
full— cached read (use for files you will edit)map— deps + API signatures (use for context-only files)signatures— API surface onlydiff— changed lines only (after edits)aggressive— syntax strippedentropy— Shannon + Jaccard filtering
Use native Edit/StrReplace when available. If Edit requires Read and Read is unavailable,
use ctx_edit(path, old_string, new_string) — it reads, replaces, and writes in one MCP call.
NEVER loop trying to make Edit work. If it fails, switch to ctx_edit immediately.
Write, Delete have no lean-ctx equivalent — use them normally.