yvgude/lean-ctx

这是什么？

核心功能

• 01多种文件读取模式，包括结构概览、函数签名和行范围，重复读取时返回紧凑引用。
• 02对 git、npm、cargo、docker、kubectl 等常用工具的 Shell 输出进行压缩。
• 03基于 Tree-sitter 的 27 种语言结构解析。
• 04本地会话记忆与用于影响分析的代码属性图。
• 05在受支持路径上应用路径权限、内容过滤和上下文预算。
• 06提供本地 CLI、MCP 服务和浏览器仪表盘，便于查看上下文活动。

适用场景

• 在大型代码仓库中使用 AI 编程智能体时减少 token 消耗。
• 避免依赖大量 Shell 命令的智能体会话被构建和测试日志占满上下文窗口。
• 借助保存的任务和决策记录，在多次对话之间延续长期项目。
• 将 AI 工具的文件系统访问限制在指定项目范围内。

快速上手

1. 1

   通过 README 中列出的包管理器（npm、crates.io 或 AUR）安装 LeanCTX

2. 2

   为受支持的 AI 工具配置集成

   lean-ctx setup
3. 3

   使用一段时间后查看本地 token 节省情况

   lean-ctx savings

使用前须知

• !README 标注为混合许可证，而元数据列为 Apache-2.0，商用前请查看 LICENSE.md。
• !多智能体交接、上下文包、快照和插件等多项功能被标注为实验性研究功能。
• !Shadow Mode 的节省量是模拟估算而非实测结果，也不能证明回答质量。

收录于专题

标签

常见问题

lean-ctx 是什么？

用 Rust 编写的开源引擎，为 AI 编程工具筛选并压缩其读取的上下文，提供 MCP 服务与 Shell 钩子。 LeanCTX 是面向 AI 工具的上下文网关。它位于编程智能体与其读取的文件、Shell 输出和工具结果之间，挑选与任务相关的内容，并压缩重复或冗余的输入，减少上下文窗口的占用。

lean-ctx 可以免费使用吗？用的什么许可证？

lean-ctx 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

lean-ctx 还在维护吗？

活跃维护中。lean-ctx 最近一次提交是在 2026年10月24日。

lean-ctx 适合用来做什么？

在大型代码仓库中使用 AI 编程智能体时减少 token 消耗。 避免依赖大量 Shell 命令的智能体会话被构建和测试日志占满上下文窗口。 借助保存的任务和决策记录，在多次对话之间延续长期项目。 将 AI 工具的文件系统访问限制在指定项目范围内。

lean-ctx 怎么安装和运行？

通过 README 中列出的包管理器（npm、crates.io 或 AUR）安装 LeanCTX 为受支持的 AI 工具配置集成: lean-ctx setup 使用一段时间后查看本地 token 节省情况: lean-ctx savings

在哪里获取 lean-ctx？

源代码和安装说明在 GitHub 上：https://github.com/yvgude/lean-ctx