Added
lean-ctx wrap <agent>— one-command setup (GH #premium-setup). Replaces
the 5-step manual setup (install → PATH → onboard → shell reload → IDE restart)
with a single command that orchestrates everything: config snapshot, shell hooks,
MCP registration, agent hooks, daemon start, MCP connection probe, and a premium
terminal summary. Undo withlean-ctx unwrap <agent>.lean-ctx unwrap <agent>— byte-for-byte config restore. Reads the wrap
snapshot and restores every modified file to its pre-wrap state, removes MCP
registration, and cleans up the snapshot directory.- MCP verify probe.
wrapspawnslean-ctx mcp, sends JSON-RPCinitializetools/list, and confirmsctx_readis present — gives instant feedback that
the MCP server works before the user opens their editor.
- Agent launch detection.
wrapchecks whether Cursor/VS Code is already
running and gives context-aware restart hints (process detection viapgrep
on macOS/Linux,taskliston Windows). - install.sh auto-PATH fix. The installer now adds
~/.local/binto PATH
automatically (appends to shell RC + exports in current session). Opt out with
LEAN_CTX_NO_PATH_FIX=1. - install.sh auto-onboard. After binary installation,
lean-ctx onboardruns
automatically. Opt out withLEAN_CTX_NO_ONBOARD=1. - npm postinstall auto-onboard.
npm install -g lean-ctx-binnow runs
lean-ctx onboardafter download (skipped in CI).
Changed
- CLI help: wrap-first progressive disclosure. Quickstart, concise help, and
full reference now lead withlean-ctx wrap <agent>as the primary getting-started
path.onboardandsetupremain available as alternatives. - README: 30-second setup. "Get started" section updated from 5 manual steps
tolean-ctx wrap cursor. - Website: wrap-first flow. Landing page hero, getting-started prompt generator,
and setup commands reference all updated to the wrap-first workflow.
Upgrade
lean-ctx update # recommended (auto-downloads + refreshes shell hooks)
cargo install lean-ctx # or
npm update -g lean-ctx-bin # or
brew upgrade lean-ctxNote: After upgrading via cargo/npm/brew, run
lean-ctx setupto refresh shell aliases.lean-ctx updatedoes this automatically.
Full Changelog: v3.9.4...v3.9.4