lean-ctx

环境要求

• macOS / Linux（brew 方式）或任意支持 curl 的系统
• Node.js 环境（npm 安装方式）或 Rust 工具链（cargo 安装方式），四选一即可
• 网络可访问 leanctx.com 或相应包仓库
• 已安装一个 AI 编码代理（如 Cursor、Claude Code、Codex）

安装与启动步骤

1. 1安装 lean-ctx

   四种方式任选一种：curl 通用安装、Homebrew、npm、cargo。无需全部执行，选与你的环境匹配的一条即可。

   curl -fsSL https://leanctx.com/install.sh | sh

   复制

2. 2命令行一键接入代理

   用 wrap 子命令把 lean-ctx 接到你正在使用的 AI 编码代理上，自动写入所需配置，无需手动改文件。

   lean-ctx wrap cursor

   复制

3. 3查看节省效果

   通过本地节省账本与 Shadow Mode 对比基线，确认 Token 压缩实际生效的幅度。

4. 4按需安装 addon

   把已有的上下文工具以签名包形式接入流水线，安装前会本地验签并列出将执行的命令，确认后才安装。

   lean-ctx addon add ./my-addon-1.0.0.ctxpkg

   复制

5. 5查看已装 addon

   列出当前已安装、会被加载以及已接线的 addon，便于排查哪些扩展已生效。

   lean-ctx addon list

   复制

如何确认成功

运行 lean-ctx wrap 对应的代理后，在代理中读文件或执行命令，观察本地节省账本与 Shadow Mode 是否显示压缩后的 Token 对比结果。

常见问题

注意事项

• README 声明为零配置、本地优先，所有处理在本机进行，敏感输出默认按不可信内容做脱敏处理。
• LeanCTX 没有应用市场，也不提供 addon search，不托管、不审核、不排名 addon。
• 若通过包管理器安装，uninstall 会清理它写入的内容，但仍需按提示用 brew/cargo/npm 对应命令卸载二进制本身。
• 示例中的 my-addon 包名为占位示意，请替换为你自己实际构建或获取的 .ctxpkg 文件路径。