CLI Reference
mochi is the flow CLI with Mochi's commands added. Every command, flow's included, has a page generated from its own help: see mochi and the list in the sidebar. This page is the overview of what Mochi adds.
The rest (exec and every verb, browse, logs, workspace, vault, secret, template, cache, config, mcp) behaves as in flow. Two differences: mochi sync also refreshes discovered tasks, and flow's cli update isn't available; update Mochi by running its installer again.
Every command that prints results takes -o, --output text|json.
Every command accepts -h, --help, plus the global flags -L, --log-level and --sync. Commands marked 🔑 need a license.
Discovery
| Command | Description |
|---|---|
mochi discover [workspace] 🔑 | Find the tasks a workspace already defines and make them runnable. --dry-run, --force, --only, --providers |
mochi discover status [workspace] 🔑 | What the last scan found, without scanning again |
mochi sync | Also re-scans the current workspace and every workspace discovered before |
Guide: Discovery
AI
| Command | Description |
|---|---|
mochi ai describe <verb> <id> 🔑 | Suggest a one-line description for an executable |
mochi ai document [workspace] 🔑 | Describe every undescribed executable. --write, --overwrite, -n |
mochi ai explain <verb> <id> 🔑 | Plain-English explanation of an executable |
mochi ai diagnose <run-id> 🔑 | Likely cause and fixes for a failed run |
mochi ai insights [workspace] 🔑 | Recommendations from run statistics. -n |
mochi ai chat [prompt] 🔑 | Ask a question with tool access to your workspaces |
mochi ai usage 🔑 | Mochi gateway usage and credits for your license |
mochi ai usage local 🔑 | Locally recorded usage for your own providers |
mochi ai config view 🔑 | Show the current provider configuration |
mochi ai config set provider <name> 🔑 | Configure and activate a provider. See AI Providers |
mochi ai config set tools --tier <tier> 🔑 | Highest tool tier chat may use: read-only, caution, edit, full |
mochi ai config set usage 🔑 | Retention for the local usage log |
mochi ai config test 🔑 | Check that the configured provider actually works |
Guide: AI
Search, favorites, and stats
| Command | Description |
|---|---|
mochi search [query] 🔑 | Usage-ranked search across executables and workspaces. -n |
mochi favorite add|remove 🔑 | Star or unstar a workspace or executable. --workspace <name> or --executable <ref> |
mochi favorite list 🔑 | List favorites |
mochi stats [workspace] 🔑 | Runs, success rates, and busiest executables. -n |
Guide: Search, Favorites & Stats
Views
| Command | Description |
|---|---|
mochi views list | List saved views |
mochi views show <view> | Render a view |
mochi views refs <view> | Print the executable references a view selects |
mochi views reset | Delete every view, including a views file that can't be read |
Guide: Views
Editing
| Command | Description |
|---|---|
mochi executable edit REF --data <json> 🔑 | Replace one executable in place, keeping comments and siblings |
mochi executable set-description REF TEXT 🔑 | Set or clear one executable's description, including a discovered one |
mochi executable add --file <path> --content <yaml> 🔑 | Append executables to an existing flow file |
mochi workspace edit NAME 🔑 | Edit --description, --display-name, --tags in place |
Guide: Editing Executables
Vault presets
| Command | Description |
|---|---|
mochi vault preset list 🔑 | Available presets |
mochi vault preset preflight --preset <p> 🔑 | Check the provider is installed and usable |
mochi vault preset connect --preset <p> 🔑 | Run the provider's sign-in step |
mochi vault preset browse --preset <p> 🔑 | List what a provider holds |
mochi vault preset render NAME --preset <p> 🔑 | Render a vault configuration file. --out, --set key=value |
Guide: Vault Presets
Desktop
| Command | Description |
|---|---|
mochi desktop 🔑 | Launch the desktop app (MOCHI_DESKTOP_PATH overrides the location) |
mochi desktop open <target> 🔑 | Open a mochi:// link or executable reference in the app |
Guide: Desktop App
License
| Command | Description |
|---|---|
mochi license set | Validate and register a license key, entered at a masked prompt, read with --file, or piped on stdin |
mochi license trial | Start a 7-day trial. --email |
mochi license status | License state, plan, and key dates on this machine |
Guide: Licensing
Telemetry
| Command | Description |
|---|---|
mochi telemetry status | Whether anonymous usage reporting is on, and the install ID |
mochi telemetry enable | Turn usage reporting on |
mochi telemetry disable | Turn it off and delete the install ID |
Reference: Telemetry
Trust
| Command | Description |
|---|---|
mochi trust list | Every workspace's trust state and rules |
mochi trust set <workspace> trusted|restricted | Trust or restrict a workspace |
mochi trust reset <workspace> | Forget a workspace's trust and rules |
mochi trust check <verb> <id> | Whether a task can run without asking |
mochi trust rule add <workspace> allow|ask <pattern> | Allow or ask for matching tasks |
mochi trust rule remove <workspace> <pattern> | Remove a rule |
Guide: Workspace Trust