v2.7.1 — Shell Safety, Cheat Sheet CLI & Bug Fixes

Fixed

• Shell hook: git status → ? — Compression fallback now preserves readable output instead of destroying it (#24)
• Compression safety floor — Output can never be compressed below 10% of original (min 5 tokens)
• Shell hook recursion — LEAN_CTX_ACTIVE=1 prevents infinite loops with .zshenv aliases (#24)
• cargo fmt CI fix — Formatting issue that caused CI pipeline failure
• Help text: 21→24 MCP tools — Corrected tool count in --help output

Added

• lean-ctx cheatsheet CLI — Color-coded workflow quick reference directly in terminal
• Workflow Guide — New /docs/workflow with 5-session cheat sheet, read mode decision tree, protocol summary (#23)
• Full docs for ctx_knowledge, ctx_agent, ctx_overview — Action tables, examples, storage paths
• CEP output token budgets — Mechanical/Standard/Architectural tiers documented
• CCP feature comparison — CCP vs ctx_knowledge vs ctx_agent
• CLI docs — lean-ctx update, slow-log, gain --live, lean-ctx-on/off/status
• pi-lean-ctx lower thresholds — map from 8KB, signatures from 96KB (PR #22 by @amiano4)

Updated

• 21→24 MCP tools across all docs, README, and website
• AUR packages updated (lean-ctx, lean-ctx-bin)
• Homebrew formula updated
• npm packages updated (lean-ctx-bin@2.7.1, pi-lean-ctx@1.0.4)
• crates.io published (lean-ctx@2.7.1)

Install

brew upgrade lean-ctx                    # Homebrew
npm install -g lean-ctx-bin@2.7.1        # npm
cargo install lean-ctx                    # Cargo
curl -fsSL https://leanctx.com/install.sh | sh  # Universal
lean-ctx update                           # Self-update

What's Changed

• fix(pi-lean-ctx): lower code read thresholds for practical compression by @amiano4 in #22

New Contributors

• @amiano4 made their first contribution in #22

Full Changelog: v2.7.0...v2.7.1