JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2556
  • Score
    100M100P100Q128090F
  • License MIT

Pi Coding Agent extension with first-class MCP support — routes bash, read, grep, find, and ls through lean-ctx CLI, and exposes all 34 lean-ctx MCP tools (ctx_session, ctx_knowledge, ctx_semantic_search, ctx_impact, ctx_architecture, etc.) natively in Pi

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (pi-lean-ctx) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    pi-lean-ctx

    Pi Coding Agent extension with first-class MCP support — routes all tool output through lean-ctx for 60–90% token savings and exposes 34 MCP tools natively in Pi.

    What it does

    Built-in Tool Overrides (CLI)

    Overrides Pi's built-in tools to route them through lean-ctx:

    Tool Compression
    bash All shell commands compressed via lean-ctx's 90+ patterns
    read Smart mode selection (full/map/signatures) based on file type and size
    grep Results grouped and compressed via ripgrep + lean-ctx
    find File listings compressed and .gitignore-aware
    ls Directory output compressed

    MCP Tools (Embedded Bridge)

    Additionally, pi-lean-ctx spawns lean-ctx as an MCP server and registers all advanced tools directly in Pi:

    Tool Purpose
    ctx_session Session state management and persistence
    ctx_knowledge Project knowledge graph with temporal validity
    ctx_semantic_search Find code by meaning, not exact text
    ctx_overview Codebase overview and architecture analysis
    ctx_compress Manual compression control
    ctx_metrics Token savings dashboard
    ctx_agent Multi-agent coordination and handoffs
    ctx_graph Dependency graph analysis
    ctx_discover Smart code discovery
    ctx_context Context window management
    ctx_preload Predictive file preloading
    ctx_delta Changed-lines-only reads
    ctx_edit Read-modify-write in one call
    ctx_dedup Duplicate context elimination
    ctx_fill Budget-aware context filling
    ctx_intent Intent-based task routing
    ctx_response Response optimization
    ctx_wrapped Wrapped command execution
    ctx_benchmark Compression benchmarking
    ctx_analyze Code analysis
    ctx_cache Cache management
    ctx_execute Direct command execution
    ctx_impact Reverse dependency analysis
    ctx_architecture Project architecture map
    ctx_heatmap File access heatmap
    ctx_task Task management
    ctx_cost Cost attribution tracking
    ctx_share Cross-agent context sharing
    ctx_smart_read Adaptive mode selection

    These MCP tools are the same ones available in Cursor, Claude Code, VS Code, and all other supported editors — now first-class in Pi. Tools are auto-discovered via MCP, so new tools added to lean-ctx are automatically available without updating this package.

    Install

    # 1. Install lean-ctx (if not already installed)
cargo install lean-ctx
# or: brew tap yvgude/lean-ctx && brew install lean-ctx

# 2. Install the Pi package
pi install npm:pi-lean-ctx

# 3. Restart Pi

    Or use the automated setup:

    lean-ctx init --agent pi

    How it works

    CLI overrides (bash, read, grep, find, ls)

    These tools invoke the lean-ctx binary via CLI with LEAN_CTX_COMPRESS=1. The output is parsed for compression stats and displayed with a token savings footer.

    MCP bridge (all other tools)

    On startup, pi-lean-ctx spawns the lean-ctx binary as an MCP server (JSON-RPC over stdio). It discovers available tools via list_tools, filters out those already covered by CLI overrides, and registers the rest as native Pi tools.

    If lean-ctx is already configured as an MCP server via pi-mcp-adapter in ~/.pi/agent/mcp.json, the embedded bridge is skipped to avoid duplicate tools.

    Automatic reconnection

    If the MCP server process crashes, the bridge automatically reconnects (up to 3 attempts with exponential backoff). If reconnection fails, CLI-based tools continue working normally — only the advanced MCP tools become unavailable.

    pi-mcp-adapter compatibility

    If you prefer using pi-mcp-adapter to manage your MCP servers, lean-ctx integrates automatically:

    # Option A: lean-ctx writes the config for you
lean-ctx init --agent pi

# Option B: Manual configuration in ~/.pi/agent/mcp.json
    {
  "mcpServers": {
    "lean-ctx": {
      "command": "/path/to/lean-ctx",
      "lifecycle": "lazy",
      "directTools": true
    }
  }
}

    When pi-mcp-adapter manages the lean-ctx MCP server, pi-lean-ctx detects this and only registers its CLI-based tool overrides, leaving MCP tool management to the adapter.

    Binary Resolution

    The extension locates the lean-ctx binary in this order:

    1. LEAN_CTX_BIN environment variable
    2. ~/.cargo/bin/lean-ctx
    3. ~/.local/bin/lean-ctx (Linux) or %APPDATA%\Local\lean-ctx\lean-ctx.exe (Windows)
    4. /usr/local/bin/lean-ctx (macOS/Linux)
    5. lean-ctx on PATH

    Smart Read Modes

    The read tool automatically selects the optimal lean-ctx mode:

    File Type Size Mode
    .md, .json, .toml, .yaml, etc. Any full
    Code files (55+ extensions) < 8 KB full
    Code files 8–96 KB map (deps + API signatures)
    Code files > 96 KB signatures (AST extraction)
    Other files < 48 KB full
    Other files > 48 KB map

    Slash Command

    Use /lean-ctx in Pi to check:

    • Which binary is being used
    • MCP bridge status (embedded vs. adapter, connected/disconnected)
    • Number and names of registered MCP tools

    Disabling specific tools

    To disable specific MCP tools, configure disabled_tools in ~/.lean-ctx/config.toml:

    disabled_tools = ["ctx_graph", "ctx_benchmark"]

    Or via environment variable:

    LEAN_CTX_DISABLED_TOOLS=ctx_graph,ctx_benchmark pi