lean-ctx

概述

lean-ctx 是一个本地优先的上下文运行时，同时作为 MCP server 和 shell hook 使用。它在内容到达 LLM 之前压缩文件读取和 shell 输出，缓存重新读取可减少到约 13 个 token。该项目提供 51 个工具、10 种读取模式和 60 多种模式，用于优化 Cursor、Claude Code 和 Copilot 等 AI 编码工具的上下文管理。它具有用于代码智能的属性图、会话内存功能和上下文打包功能，可在项目间共享。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• ctx_refactor

  Language-server-powered refactoring operations (rename, references, go-to-definition, find-implementations)

  试试:Rename this function throughout the codebase试试:Find all references to this variable试试:Show me where this interface is implemented
• ctx_expand

  Archive full-text search over all previously archived tool outputs

  试试:Search for all previous mentions of user authentication试试:Find past conversations about API performance试试:Search the archive for database connection issues
• ctx_read

  Cached + mode-aware file reads with multiple options

  试试:Read this file in map mode to see its structure试试:Get the signatures of all functions in this file试试:Show me the diff of this file compared to the last commit
• ctx_pack

  Create context packages bundling knowledge, graph, session, and gotchas

  试试:Create a context package for this feature branch试试:Pack the current session into a shareable .lctxpkg file试试:Create a package with all related files for this bug
• ctx_search

  Search across codebase with hybrid search capabilities

  试试:Find all functions that handle user authentication试试:Search for similar code patterns across the project试试:Find all implementations of this trait
• ctx_memory

  Persist and query session facts across multiple conversations

  试试:What decisions did we make about database schema?试试:Recall previous work we did on authentication flow试试:What were the key findings from our last discussion?
• ctx_graph

  Query the property graph for code relationships and impact analysis

  试试:Show me the impact of changing this function试试:Find files that are related to this module试试:What imports are affected by this change?
• ctx_benchmark

  Benchmark and measure compression effectiveness by language and mode

  试试:Run a benchmark on the current repository试试:Show compression metrics for TypeScript files试试:Compare token savings across different read modes
• ctx_inspect

  Inspect repository structure and configuration

  试试:Show me the project configuration试试:List all supported file types in this repository试试:What compression patterns are active for this project?
• ctx_export

  Export context data for external tools or sharing

  试试:Export current context to a JSON file试试:Prepare context for external analysis tool试试:Share session context with a teammate
• ctx_import

  Import external context or previous sessions

  试试:Import context from a previous session file试试:Load context package from a .lctxpkg file试试:Restore context from backup
• ctx_analyze

  Analyze code patterns and provide insights

  试试:Analyze code quality issues in this file试试:Identify potential performance bottlenecks试试:Check for security vulnerabilities in this code

可对比工具

安装

# 通用安装程序（不需要 Rust）
curl -fsSL https://leanctx.com/install.sh | sh

# macOS / Linux 通过 Homebrew
brew tap yvgude/lean-ctx && brew install lean-ctx

# Node.js
npm install -g lean-ctx-bin

# Rust
cargo install lean-ctx

# Pi 编码代理
pi install npm:pi-lean-ctx

lean-ctx setup

{
  "mcpServers": {
    "lean-ctx": {
      "command": "lean-ctx",
      "args": ["mcp"]
    }
  }
}

FAQ

lean-ctx 支持哪些 AI 编码工具？

lean-ctx 支持 20 多种 AI 编码工具，包括 Cursor、Claude Code、GitHub Copilot、Windsurf、Gemini 等。它可与任何 MCP 兼容的客户端配合使用，并为 VS Code、Neovim 和 JetBrains 等各种 IDE 提供特定集成。

lean-ctx 如何减少 token 使用？

lean-ctx 通过缓存文件读取并压缩（缓存重新读取可减少到约 13 个 token）、使用 60 多种模式压缩 shell 输出，以及使用智能读取模式（仅根据任务发送相关上下文）来减少 token 使用。

lean-ctx 对比