lean-ctx

# LeanCTX — Context Engineering for AI Agents LeanCTX optimizes LLM context through 81 MCP tools, 95+ shell compression patterns, and tree-sitter AST parsing for 26 languages. It provides adaptive file reading, cross-session memory (CCP), task-conditioned relevance scoring, and a feedback loop for learning optimal compression. ## Setup (run first) Before using lean-ctx, verify it is installed: ```bash which lean-ctx || bash scripts/install.sh ``` If the install script is not available locally, install manually: ```bash curl -fsSL https://raw.githubusercontent.com/yvgude/lean-ctx/main/skills/lean-ctx/scripts/install.sh | bash ``` After installation, run the one-command setup (installs shell hook + editor wiring + rules + skills): ```bash lean-ctx setup ``` lean-ctx supports two integration styles (auto-detected per agent): - **Hybrid (default where shell access exists)**: MCP for cached reads/search + shell hooks that compress command output. - **MCP (for IDE-extension agents without reliable shell hooks)**: cached reads + all tools via MCP. ## When to use lean-ctx Prefer the current shell's configured compression over nested wrappers. In agent shells, run commands normally unless the user explicitly asks for `lean-ctx -c <command>` or task setup/docs explicitly say the shell is not wrapped. Do not inspect env vars just to decide; users may forbid env access. Use `lean-ctx -c <command>` over running commands directly only when: - The command produces verbose output...