Documentation / Advanced
Target the installation you have
The CLI adapts routes, headers and payloads to a frozen installation contract. A newer CLI does not upgrade the installation implicitly.
Inspect the command contract locally
These commands do not contact a Controller. Compare supported command families before connecting to an older installation.
rippflow commands --installation-version 1.0.4 --json
rippflow commands --installation-version 1.8.1 --jsonResolve the target explicitly
Discovery uses the Controller installation/release endpoint. An explicit --installation-version X.Y.Z or RIPPFLOW_INSTALLATION_VERSION selects the target contract. Unsupported commands fail closed with an actionable version diagnostic.
Controls start at 1.4.0, governed tools/MCP at 1.7.0, Enterprise group RBAC at 1.8.0 and signed release management at 1.8.1 in the current catalog. Capabilities and permissions still apply.
Develop locally first
Doctor, scaffold/examples, validation, dev/test, reports, TUI, profiling and Docker support iteration. On macOS (Rippflow.app), Windows, and Linux (./install.sh / rippflow install), installing Rippflow Studio places rippflow on your PATH, registers Rippflow Studio in your Applications menu, Desktop tile, and taskbar, and provides the built-in rippflow studio (aliases rippflow app / rippflow shell) desktop workspace (GPUI + Longbridge gpui-kit + alacritty_terminal with guided 5-step onboarding, System/Light/Dark Rippflow theme toggle, and AppBar CLI authentication state). Local mode uses in-memory state and trusted executables. It does not emulate all cloud retry, durability, IAM or failover guarantees.
See Quickstart and local development.
CLI self-update also verifies its signed release metadata. Use only a supported release channel/trust root; a newer CLI cannot manufacture a missing installer or installation capability.
All 38 CLI command families
| Command | Minimum installation | Guide |
|---|---|---|
rippflow deploy | 1.0.0 | Guide → |
rippflow whoami | 1.0.0 | Guide → |
rippflow auth | 1.0.0 | Guide → |
rippflow config | 1.0.0 | Guide → |
rippflow workflows | 1.0.0 | Guide → |
rippflow executions | 1.0.0 | Guide → |
rippflow analytics | 1.8.1 | Guide → |
rippflow monitor | 1.8.1 | Guide → |
rippflow accounting | 1.0.6 | Guide → |
rippflow retention | 1.8.1 | Guide → |
rippflow users | 1.0.0 | Guide → |
rippflow cells | 1.2.0 | Guide → |
rippflow distributions | 1.2.0 | Guide → |
rippflow controls | 1.4.0 | Guide → |
rippflow tools | 1.7.0 | Guide → |
rippflow mcp | 1.7.0 | Guide → |
rippflow operations | 1.7.0 | Guide → |
rippflow rbac | 1.8.0 | Guide → |
rippflow releases | 1.8.1 | Guide → |
rippflow installation | 1.0.0 | Guide → |
rippflow versions | 1.0.0 | Guide → |
rippflow activate | 1.0.0 | Guide → |
rippflow rollback | 1.0.0 | Guide → |
rippflow init | 1.0.0 | Guide → |
rippflow validate | 1.0.0 | Guide → |
rippflow dev | 1.0.0 | Guide → |
rippflow test | 1.0.0 | Guide → |
rippflow generate | 1.0.0 | Guide → |
rippflow inspect | 1.0.0 | Guide → |
rippflow ui | 1.0.0 | Guide → |
rippflow get_doc | None (local only) | Guide → |
rippflow get_docs | None (local only) | Guide → |
rippflow search_docs | None (local only) | Guide → |
rippflow vector_search_docs | None (local only) | Guide → |
rippflow docs | None (local only) | Guide → |
rippflow deployments | 1.9.0 | Guide → |
rippflow login | 1.8.2 | Guide → |
rippflow logout | 1.0.0 | Guide → |
Verified sources
Checked 2026-11-05.
- version_compat.rs 7f5ea32 · main
- main.rs 7f5ea32 · main
- updater.rs 7f5ea32 · main
