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

Main

• 先跑 lean-ctx setup + doctor，确认 MCP 与 shell hook 在你的 agent/editor 里真的生效。

• 按需选择读取模式：map/signatures/diff 等模式能显著省 token，同时保留重构所需的关键信息。

• 跨容器/多工作区共享仓库时，按 README 建议用 .lean-ctx-id 区分项目，避免缓存/上下文串库。

Source-backed notes

• README 标题区写明：可减少 60–95% token（缓存读取最高到 99%），并列出 59 tools / 10 read modes。
• README 给出 60 秒上手流程：安装 → lean-ctx setup → lean-ctx doctor → lean-ctx gain --live。
• README 提供兼容矩阵，并给出按 agent 初始化的命令，如 lean-ctx init --agent codex / ... --agent claude。

FAQ

• 它只是 MCP server 吗？：不止。README 说明它同时包含 MCP server 与压缩命令行输出的 shell hook。
• 能不能快速停用？：可以。README 的 Troubleshooting 区域给了当前 shell 立即停用命令 lean-ctx-off。
• 新手怎么安全开始？：先在日常开发中开 gain --live 观察节省效果，再逐步引入不同读取模式。