╭──────────────────────────────────────────╮ ╭──────────────────────────────────────────╮ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ lean-ctx ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ lean-ctx ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ╚══════════════╝ ╚══════════╝ ╚══════════════╝ ╚══════════╝ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ file file file file read cache send tok tok tok tok tok tok file file file file read cache send tok tok tok tok tok tok ╭──────────────────────────────────────────╮ ╭──────────────────────────────────────────╮ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ lean-ctx ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ lean-ctx ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ╚══════════════╝ ╚══════════╝ ╚══════════════╝ ╚══════════╝ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ file file file file read cache send tok tok tok tok tok tok file file file file read cache send tok tok tok tok tok tok

Universal Compatibility

Works With Any
AI Tool.

One install. One setup command. lean-ctx adds a cognitive context layer to every AI tool that uses MCP — and even those that don't benefit from shell hook intelligence.

61 MCP tools + shell hook context layer

Full MCP Support

Aider

Mode-based (Hybrid / MCP)

lean-ctx init --agent aider

Amazon Q Developer

Mode-based (Hybrid / MCP)

lean-ctx init --agent amazonq

Amp

Mode-based (Hybrid / MCP)

lean-ctx init --agent amp

Antigravity

Mode-based (Hybrid / MCP)

lean-ctx setup

AWS Kiro

Mode-based (Hybrid / MCP)

lean-ctx init --agent kiro

Claude Code

Mode-based (Hybrid / MCP)

lean-ctx init --agent claude

Cline

Mode-based (Hybrid / MCP)

lean-ctx init --agent cline

Continue

Mode-based (Hybrid / MCP)

lean-ctx setup

Crush

Mode-based (Hybrid / MCP)

lean-ctx init --agent crush

Cursor

Mode-based (Hybrid / MCP)

lean-ctx setup

Emacs

Mode-based (Hybrid / MCP)

lean-ctx init --agent emacs

Gemini CLI

Mode-based (Hybrid / MCP)

lean-ctx init --agent gemini

GitHub Copilot

Mode-based (Hybrid / MCP)

lean-ctx init --agent copilot

Hermes Agent

Mode-based (Hybrid / MCP)

lean-ctx init --agent hermes

JetBrains IDEs

Mode-based (Hybrid / MCP)

lean-ctx init --agent jetbrains

Neovim

Mode-based (Hybrid / MCP)

lean-ctx init --agent neovim

OpenAI Codex

Mode-based (Hybrid / MCP)

lean-ctx init --agent codex

OpenCode

Mode-based (Hybrid / MCP)

lean-ctx init --agent opencode

Pi

Mode-based (Hybrid / MCP)

lean-ctx init --agent pi

Qoder

Mode-based (Hybrid / MCP)

lean-ctx init --agent qoder

QoderWork

Mode-based (Hybrid / MCP)

lean-ctx init --agent qoderwork

Qwen Code

Mode-based (Hybrid / MCP)

lean-ctx init --agent qwen

Roo Code

Mode-based (Hybrid / MCP)

lean-ctx init --agent roo

Sublime Text

Mode-based (Hybrid / MCP)

lean-ctx init --agent sublime

Trae

Mode-based (Hybrid / MCP)

lean-ctx init --agent trae

Verdent

Mode-based (Hybrid / MCP)

lean-ctx init --agent verdent

Windsurf

Mode-based (Hybrid / MCP)

lean-ctx init --agent windsurf

Zed AI

Mode-based (Hybrid / MCP)

lean-ctx setup

No MCP? No problem.

Shell Hook Only

Tools that don't support MCP still benefit from lean-ctx. The shell hook intercepts CLI commands (git, npm, cargo, docker, kubectl, ls, find, and 60+ more) and compresses their output before the AI sees it.

OpenClawAny CLI-based AI tool

Shell Hook

Intercepts git, npm, cargo, docker, kubectl, pip, go, tsc, and 60+ more commands. Compresses output by 60–90%.

MCP Server

61 specialized tools: ctx_read, ctx_search, ctx_graph, ctx_intent, ctx_session, ctx_task, ctx_cost, and 54 more. Intent-aware compression, session memory, context routing, multi-agent handoffs, knowledge graphs.

[x] [-] [o] lean-ctx setup

$ lean-ctx setup

◆ lean-ctx Setup Wizard

────────────────────────────────────

✓ Shell detected: zsh

✓ Hook installed: ~/.zshrc

✓ AI tool detected: Cursor

✓ Hooks installed: ~/.cursor/hooks.json

✓ AI tool detected: Claude Code

✓ MCP server added: claude mcp add

────────────────────────────────────

Setup complete. Restart your shell.

2 AI tools configured, shell hook active

Zero manual config

How Setup Works

Detects your shell

Finds zsh, bash, or fish and installs the shell hook that intercepts CLI commands.

Finds AI tools

Scans for Cursor, Claude Code, Copilot, Windsurf, Pi, Cline, Zed, and others. Configures MCP for each.

Writes MCP config

Creates the correct JSON config for each tool. No manual editing required.

Built on an Open Standard

MCP (Model Context Protocol) is the open standard for connecting AI tools to external capabilities. Any future tool that supports MCP will work with lean-ctx automatically - no updates needed.

One binary. One protocol. Every AI tool.

Stability

Contract Versioning & Stability

LeanCTX is infrastructure. Contracts are stable promises that tools, configs, and integrations can rely on.

Versioning Rules

Schema versions are integers (1, 2, 3…) — schema_version / contract_version
Breaking change — bumps the version; old schema still accepted for 2 major releases
Non-breaking change — version stays the same; additive fields are always safe

CI Gates

contracts_md_up_to_date ensures CONTRACTS.md stays in sync with code
mcp_manifest_up_to_date ensures the tool manifest stays the single source of truth

Related Contracts

Works with your tools. Today.

One install, one lean-ctx setup, and every AI tool you use starts saving tokens. No per-tool configuration.

Get Started Star on GitHub

Works With AnyAI Tool.

Full MCP Support

Aider

Amazon Q Developer

Amp

Antigravity

AWS Kiro

Claude Code

Cline

Continue

Crush

Cursor

Emacs

Gemini CLI

GitHub Copilot

Hermes Agent

JetBrains IDEs

Neovim

OpenAI Codex

OpenCode

Pi

Qoder

QoderWork

Qwen Code

Roo Code

Sublime Text

Trae

Verdent

Windsurf

Zed AI

Shell Hook Only

How Setup Works

Detects your shell

Finds AI tools

Writes MCP config

Built on an Open Standard

Contract Versioning & Stability

Versioning Rules

CI Gates

Related Contracts

Works with your tools. Today.

Works With Any
AI Tool.