Every CLI command lean-ctx exposes, grouped by purpose. Source of truth:
rust/src/cli/dispatch/mod.rs. Aliases are shown in parentheses.
Tip: lean-ctx help shows the short list of everyday commands;
lean-ctx help all shows the full reference.
| Command | Purpose |
|---|
onboard | Zero-prompt golden path: connect all detected AI tools |
setup | Guided wizard (full control); flags: --non-interactive, --yes, --fix, --json, --skip-rules, --no-auto-approve |
install | Alias for setup; install --repair = non-interactive refresh |
bootstrap | Non-interactive setup + fix (CI/scripts); --json |
init --global | Install shell aliases/hook only |
init --agent <name> | Configure MCP + rules + skill + hook for one agent |
doctor | Diagnostics; --fix, --json, integrations |
status | Quick "am I connected?"; --json |
| Command | Purpose |
|---|
-c / exec "cmd" | Run a shell command with compressed output (--raw = full) |
-t / --track "cmd" | Track a command (full output + stats, no compression) |
shell | Interactive shell with compression |
bypass "cmd" | Run with zero compression |
read <file> | Read with compression; -m/--mode, --fresh |
diff <a> <b> | Compressed file diff |
grep <pattern> [path] | Search with compressed output |
find <pattern> [path] | Find files (compressed) |
ls [path] | Compressed directory map; --depth, -a |
deps [path] | Show project dependencies |
gain | Token-savings dashboard; --live, --graph, --daily, --json, --wrapped, --svg, --share, --copy, --open, --publish, --leaderboard, --unpublish, --cost, --tasks, --agents, --heatmap |
token-report (report-tokens) | Token + memory report; --json |
learning | Adaptive-learning state: status, export [file], import <file|-> — share learned thresholds + LITM calibration with your team (secret-free, idempotent merge) |
introspect | Cognition v2 activity: cognition (which science subsystems are wired/active, --json), qubo (experimental QUBO-vs-greedy selection benchmark) |
discover | Find uncompressed commands in shell history; --card (shareable "before" SVG) |
ghost | Ghost-token report (hidden waste); --json |
cheatsheet (cheat) | Workflow cheat sheet |
dashboard | Web dashboard (localhost:3333); --port, --host |
| Command | Purpose |
|---|
session | Tasks/findings/decisions + adoption stats: task, finding, decision, save, load, status, reset |
sessions (session-store) | Manage saved CCP snapshots: list, show, cleanup, doctor |
knowledge | Project knowledge: remember, recall, search, export, import, remove, status, health |
overview [task] | Project overview (task-contextualized) |
compress | Context-compression checkpoint; --signatures |
control | Context field manipulation: exclude/pin/priority |
plan <task> | Context planning (Phi-scored); --budget |
compile | Context compilation (knapsack + Boltzmann); --mode, --budget |
ledger | Context-ledger: status, reset, evict, prune |
| Command | Purpose |
|---|
graph | Property graph: build, related, impact, symbol, context, status, export-html |
smells | Code-smell detection (8 rules): scan, summary, rules, file |
visualize | Interactive HTML report (D3); --output, --open |
index | Index utilities: status, build, build-full, build-graph, watch |
heatmap | Context heatmap; --top, --by |
cep | CEP impact report (score trends) |
benchmark | run, report, eval, compare |
| Command | Purpose |
|---|
serve | MCP over Streamable HTTP; --daemon, --root PATH[:ALIAS] (multi-repo), --rrf-k |
proxy | API proxy: start, stop, status, enable, disable, cleanup |
daemon | IPC daemon: start, stop, status, enable, disable |
provider | External provider OAuth (Jira): auth, logout, list |
team | Team server (feature-gated): serve, token create, sync |
plugin (plugins) | list, enable, disable, info, init, hooks |
rules | ContextOps governance: sync, diff, lint, status, init |
pack | Context Package Manager + PR pack (create, install, export, import, pr, …) |
compact [path] | Compress agent transcripts |
learn | Learned gotchas; --apply → AGENTS.md |
gotchas (bugs) | Bug memory: list, clear, export, stats |
buddy (pet) | Token Guardian companion |
safety-levels (safety) | Compression safety-level table |
| Command | Purpose |
|---|
update (--self-update, upgrade) | Self-update; --check, --insecure, --skip-rules, --schedule [off|status|notify|<h>h] |
stop | Stop ALL lean-ctx processes (LaunchAgent-safe) |
restart | Restart daemon (apply config.toml) |
dev-install | Build release + atomic install + restart (dev) |
uninstall | Stop processes + remove configs, autostart, data, and the binary; --dry-run, --keep-config, --keep-binary |
cache | Read cache: stats, clear, reset, invalidate, prune |
harden | Harden native read/grep in MCP configs; --hard, --undo |
| Command | Purpose |
|---|
tools | MCP tool profile: minimal, standard, power, show, list |
allow | Shell allowlist: add/remove commands in shell_allowlist_extra, --list shows the effective allowlist + any parse errors |
trust / untrust | Workspace trust: gate a cloned repo's project-local .lean-ctx.toml security overrides; trust status, trust --list |
profile | Context profiles: list, show, active, diff, create, set |
config | Config file: dump, init, set <k> <v>, schema, validate, show, apply |
theme | Terminal colors: list, set, export, import |
terse / compression | Compression level: off, lite, standard, max |
filter | Custom compression filters: list, validate, init |
tee | Output tee logs: list, clear, show, last |
slow-log | Slow commands: list, clear |
stats | Raw stats store: summary, reset-cep, json |
| Command | Purpose |
|---|
login <email> | Cloud login |
register <email> | Create cloud account |
forgot-password <email> | Password reset email |
sync | Upload local stats to cloud |
contribute | Share anonymized compression data |
cloud | status, pull-models |
| Command | Purpose |
|---|
mcp | Explicit stdio MCP server |
hook <sub> | Agent hook entry points (Cursor/Claude/Copilot/Codex) |
audit | Compliance report from audit trail |
instructions | Compile MCP instructions for a client |
export-rules | High-confidence knowledge → rules files |
proof / verify | Context-proof artifacts |
report-issue (report) | Open a GitHub issue with diagnostics |
The dispatch exposes ~35 commands not yet in lean-ctx help all, including
provider, team, heatmap, ledger, control, plan, compile,
compact, learn, stats, bypass, safety-levels, and several subcommands
(graph export-html, proxy enable/disable, cache prune, full pack
actions). These are intentionally advanced/internal but should be surfaced in a
future help advanced tier. See Journey 1 UX notes.