Files
wehub-resource-sync 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
chore: import upstream snapshot with attribution
2026-07-13 12:35:30 +08:00

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 only
  • diff — changed lines only (after edits)
  • aggressive — syntax stripped
  • entropy — 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.