yvgude--lean-ctx/docs/reference/appendix-cli-map.md

Appendix — CLI Command Map

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.

Getting started / setup

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

Daily use

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

Memory & sessions

Command	Purpose
session	Tasks/findings/decisions + adoption stats: task, finding, decision, save, load, status, reset
sessions (session-store)	Manage saved CCP snapshots: list, show, delete, cleanup, doctor
knowledge	Project knowledge: remember, recall, search, export, import, remove, consolidate [--all], status, health, lifecycle
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

Code intelligence

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

Advanced — network / providers / team / plugins

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

Lifecycle

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

Tools / profiles / config

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

Cloud

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

Internal / hidden (used by agents, not for daily use)

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

Known help-text drift (tracked for cleanup)

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.