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
33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
# 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`:
|
|
|
|
```bash
|
|
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.
|