lean-ctx — Context Runtime (MCP + Shell Hook)

Main

• Start with lean-ctx setup + doctor to ensure the MCP server and shell hook are actually active for your agent/editor.

• Use read modes intentionally: map/signatures/diff modes reduce tokens while still giving enough context for refactors.

• If you share a repo across containers/workspaces, follow the README guidance on repo IDs (.lean-ctx-id) to avoid cache/context collisions.

Source-backed notes

• README headline claims 60–95% token reduction (up to 99% on cached reads) and lists 59 tools and 10 read modes.
• README provides a 60-second install flow: install → lean-ctx setup → lean-ctx doctor → lean-ctx gain --live.
• README includes a compatibility matrix with agent-specific init commands like lean-ctx init --agent codex and ... --agent claude.

FAQ

• Is this only an MCP server?: No — README describes both an MCP server and a shell hook that compresses CLI output.
• Can I disable it quickly?: Yes — README lists an immediate disable command (lean-ctx-off) for the current shell.
• What’s a safe first workflow?: Run gain --live while doing normal dev tasks to see token savings before changing read modes.