Appendix

C. CLI catalog

Every user-visible matcha entry. Bare matcha (no subcommand) is the interactive TUI and is not a subcommand.

Default invocation

Invocation	Hide	Mode A	See
`matcha`	no	available	Three ways to run Matcha; First launch and the welcome screen
`matcha "<prompt>"`	no	available	Same
`matcha -p` / `--single` / `--print`	no	available	Headless and CI
`matcha -c` / `--continue`	no	available	New, resume, rename, delete
`matcha -r` / `--resume`	no	available	New, resume, rename, delete
`matcha --minimal` / `--fullscreen`	no	available	Fullscreen vs minimal
`matcha --oauth` (root flag)	no	unavailable	Appendix A

Subcommands

CLI	Hide	Mode A	See
`matcha agent`	no	available (`stdio`); relay `headless` is out	Headless and CI; ACP / stdio
`matcha inspect`	no	available	Inspect what Matcha discovered
`matcha doctor`	no	available	Doctor and inspect
`matcha leader`	no	available (local process management)	Leader processes
`matcha logout`	no	available	Configure a Provider (BYOK)
`matcha login`	no	BYOK available; `--oauth` / `--device-auth` unavailable; `--legacy` hidden; `--devbox` skipped	Configure a Provider (BYOK)
`matcha mcp`	no	available (user-configured)	Local MCP servers
`matcha plugin`	no	local install available; `plugin marketplace` unavailable	Local plugins
`matcha memory`	no	available (local clear)	Memory
`matcha models`	no	available	Switch models
`matcha sessions`	no	available (local history)	New, resume, rename, delete
`matcha setup`	no	unavailable	Appendix A
`matcha share`	hide	unavailable; handler bails	Appendix A
`matcha wrap`	hide when not Unix/Windows	available	Clipboard wrap
`matcha export`	no	available	Export locally
`matcha trace`	no	upload unavailable; `--local` available	Appendix A; Local usage and release notes
`matcha update`	no (`--enterprise` hidden)	unavailable	Appendix A
`matcha version` (alias `v`); also `-v` / `-V` / `--version`	no	available	Supported platforms
`matcha completions`	no	available	Build from source
`matcha worktree`	no	available	Git worktrees
`matcha du` (alias `disk-usage`)	no	available	Disk usage
`matcha workspace`	hide	unavailable	Appendix A
`matcha dashboard`	no	available when `[dashboard].enabled` and `MATCHA_AGENT_DASHBOARD` is not `0`	Assistant dashboard

Nested subcommands

Parent	Nested	Hide	Mode A	See
`agent`	`stdio`	no	available	ACP / stdio
`agent`	`headless`	no	unavailable	Appendix A
`agent`	`serve`	no	local bind; do not teach product relay	ACP / stdio
`agent`	`leader`	no	available	Leader processes
`doctor`	`fix [ID] [--yes]`	no	available	Doctor and inspect
`leader`	`list`, `info`, `kill`	no	available	Leader processes
`login`	`--provider`, `--from-env`, `--validate`	no	available	Configure a Provider (BYOK)
`login`	`--oauth` / `--oidc`, `--device-auth` / `--device-code`	no	unavailable	Appendix A
`mcp`	`list`, `add`, `remove`, `enable`, `disable`, `doctor`	no	available	Local MCP servers
`plugin`	`list`, `install`, `uninstall` (`rm`/`remove`), `update`, `enable`, `disable`, `details`, `validate`, `tag`	no	available for local paths	Local plugins
`plugin`	`marketplace` (`list`/`add`/`remove`/`update`)	no	unavailable	Appendix A
`memory`	`clear` (`--workspace` / `--global` / `--all`)	no	available	Memory
`sessions`	`list`, `search`, `delete`	no	available	New, resume, rename, delete
`worktree`	`list` (`ls`), `show`, `rm`, `gc` (`prune`), `db`	no	available	Git worktrees
`workspace`	`start`, `pause`, `resume`, `stop`, `restart`, `status` (`list`)	hide (parent)	unavailable	Appendix A

Hidden root flags

These parse, and they are omitted from --help. Do not teach them:

--trust / --trust-folder
--load (alias of --resume)
--compaction-mode, --compaction-detail
--no-ask-user, --no-wait-for-background, --background-wait-timeout
--storage-mode, --client-identifier, --hunk-tracker-mode
--terminal, --fs-read, --fs-write
--no-auto-update, --todo-gate, --installer
--log-sampling, --force-login
top-level --leader / --no-leader

The grok argv0 is a compatibility shim for the same command set. See Migrating from Grok Build.