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.

shell
rippflow commands --installation-version 1.0.4 --json
rippflow commands --installation-version 1.8.1 --json

Resolve 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
CommandMinimum installationGuide
rippflow deploy1.0.0Guide →
rippflow whoami1.0.0Guide →
rippflow auth1.0.0Guide →
rippflow config1.0.0Guide →
rippflow workflows1.0.0Guide →
rippflow executions1.0.0Guide →
rippflow analytics1.8.1Guide →
rippflow monitor1.8.1Guide →
rippflow accounting1.0.6Guide →
rippflow retention1.8.1Guide →
rippflow users1.0.0Guide →
rippflow cells1.2.0Guide →
rippflow distributions1.2.0Guide →
rippflow controls1.4.0Guide →
rippflow tools1.7.0Guide →
rippflow mcp1.7.0Guide →
rippflow operations1.7.0Guide →
rippflow rbac1.8.0Guide →
rippflow releases1.8.1Guide →
rippflow installation1.0.0Guide →
rippflow versions1.0.0Guide →
rippflow activate1.0.0Guide →
rippflow rollback1.0.0Guide →
rippflow init1.0.0Guide →
rippflow validate1.0.0Guide →
rippflow dev1.0.0Guide →
rippflow test1.0.0Guide →
rippflow generate1.0.0Guide →
rippflow inspect1.0.0Guide →
rippflow ui1.0.0Guide →
rippflow get_docNone (local only)Guide →
rippflow get_docsNone (local only)Guide →
rippflow search_docsNone (local only)Guide →
rippflow vector_search_docsNone (local only)Guide →
rippflow docsNone (local only)Guide →
rippflow deployments1.9.0Guide →
rippflow login1.8.2Guide →
rippflow logout1.0.0Guide →
Verified sources

Checked 2026-11-05.

Let's talk

Contact Rippflow

Tell us about your workflows, deployment or pricing.

We'll reply to your email.

Search docs

Search workflows, handlers and operations.