yvgude/lean-ctx v2.18.0

on GitHub

Multi-Agent Context Sharing, Semantic Caching, Dashboard & Editor Integrations

Added — Multi-Agent

• ctx_share tool (28th MCP tool) — Share cached file contexts between agents. Actions: push, pull, list, clear
• ctx_agent handoff action — Transfer a task to another agent with a summary message, automatically marks the handing-off agent as finished
• ctx_agent sync action — Combined overview of active agents, pending messages, and shared contexts
• lctx --agents flag — Launch multiple agents in parallel: lctx --agents claude,gemini starts both in the background with shared context
• Dashboard /api/agents enhancement — Returns structured JSON with active agents, pending messages, and shared context count

Added — Intent & Semantic Intelligence

• Multi-intent detection — ctx_intent now detects compound queries ("fix X and then test Y") and splits them into sub-intents with individual classifications
• Complexity classification — ctx_intent returns task complexity (mechanical/standard/architectural) based on query analysis, target count, and cross-cutting keywords
• Heat-ranked file strategy — ctx_intent file discovery ranks results by heat score (token density + graph connectivity)
• Semantic cache — TF-IDF + cosine similarity index for finding semantically similar files across reads. Persistent at ~/.lean-ctx/semantic_cache/. Cache warming suggestions based on access patterns. Hints shown on ctx_read cache misses

Added — Dashboard & CLI

• lean-ctx heatmap — New CLI command for context heat map visualization with color-coded token counts and graph connections
• Dashboard authentication — Bearer token auth for /api/* endpoints, token generated on first launch at ~/.lean-ctx/dashboard_token
• Heatmap API — GET /api/heatmap returns project-wide file heat scores as JSON

Added — Editor Integrations

• VS Code Extension (packages/vscode-lean-ctx) — Status bar token savings, one-click setup, MCP auto-config for GitHub Copilot, command palette (setup, doctor, gain, dashboard, heatmap)
• Chrome Extension (packages/chrome-lean-ctx) — Manifest V3, auto-compress pastes in ChatGPT, Claude, Gemini. Native messaging bridge for full compression, fallback for comment/whitespace removal

Changed

• MCP tool count: 25 → 28 across all documentation, READMEs, SKILL.md, and 11 website locales

Upgrade

cargo install lean-ctx          # or
npm update -g lean-ctx-bin      # or
brew upgrade lean-ctx

Full Changelog: v2.18.0...v2.18.0