Repository navigation
CLI Reference
Varun S V edited this page Oct 16, 2026
·
1 revision
Install from npm: npm install -g cascade-ai. Run cascade --help and /help to inspect the commands supported by your installed version.
| Command | Meaning |
|---|---|
cascade |
Open Ink interactive terminal |
cascade run "prompt" |
Run one prompt and exit |
cascade init [path] |
Initialize project configuration |
cascade doctor |
Diagnose configuration and provider access |
cascade link [provider] |
Link supported existing CLI credentials |
cascade models |
List models and configure tier selections |
cascade stats |
Review model performance/routing history |
cascade index [path] |
Build or refresh code-search index |
cascade export |
Export a session to Markdown or JSON |
cascade dashboard |
Start the local dashboard (loopback default: port 4891) |
cascade login / logout / whoami |
Manage a Cascade Cloud session |
cascade sessions |
View, branch, rename or remove cloud chats |
cascade sync push / pull |
Explicitly transfer encrypted settings |
cascade mcp connect / list / remove |
Manage MCP servers |
cascade identity |
Manage identities |
cascade telemetry |
Opt-in telemetry settings |
cascade update |
Update the installed version |
Global options include --prompt, --workspace, --identity, --theme, --alt-screen and --no-color.
| Area | Commands |
|---|---|
| Chats |
/help, /exit, /clear, /sessions, /resume, /branch, /search, /retry, /rollback, /compact, /export, /copy
|
| Running work |
/plan, /replan, /steer, /auto, /continue, /budget
|
| Inspecting |
/status, /tree, /comms, /why, /cost, /logs, /diagnose, /audit
|
| Models |
/model, /model-info, /models, /providers, /rate good, /rate bad
|
| Setup |
/config, /mcp, /identity, /theme
|
cascade init
cascade doctor
cascade models
cascade run "Explain why the integration tests fail. Make no file changes."
cascade export --format markdownThe project's configuration is .cascade/config.json. Enable and build the code index before expecting code_search to work. The alternate-screen mode provides in-app scrollback instead of conventional shell history scrolling.
Surface distinction: the CLI's optional headless Playwright browser is not the Electron/Cloud live browser-control interface. See Browser-Control.
Sources: src/cli/index.ts, slash registry.