Rudder CLI: General Availability

Rudder CLI is now Generally Available with the v1.0.0 release. It is agent-first: an agent writes your pipelines and business rules as versioned YAML, you approve the change, and you apply that spec to any environment.

The resources it manages — tracking plans and Data Catalog, Event Stream sources, destinations, connections, transformations and libraries, Data Graphs, and Reverse ETL sources and accounts — are covered by the stable rudder/v1 spec format. From here on the CLI follows semantic versioning, so a spec that applies cleanly today keeps applying until a major release.

Rudder CLI is Generally Available on all RudderStack plans. Conditional Validation remains in Private Beta.

See the Rudder CLI Overview for the full feature set.

Why we made this change

In Public Beta, Rudder CLI did not guarantee backward compatibility between releases. That is hard to build a deployment pipeline on: a spec that applied in one release could need edits in the next, so teams kept workspace changes manual or pinned an old binary and stopped upgrading.

GA changes the contract, not the commands. rudder/v1 is the stable spec format, releases follow semantic versioning, and a change that forces you to edit specs, flags, or workflows lands only in a major release and is recorded in BREAKING_CHANGES.md.

What’s new

• Agent-first infrastructure as code: An agent writes pipelines and business rules as YAML. You review that change, then apply it to any environment.
• A stable spec contract: rudder/v1 is the supported format. Upgrade a rudder/0.1 project in place with rudder-cli migrate --location <path>.
• Semantic versioning: Patch and minor releases keep your specs working; breaking changes are reserved for a major version.
• 46 destination types: Amplitude, Braze, Salesforce, Snowflake, BigQuery, Apache Kafka, Google Analytics 4, and more, each with a per-type config reference.
• Typed bindings from your tracking plans: RudderTyper v2 generates TypeScript, Kotlin, and Swift bindings from a Tracking Plan, including from local specs with --local.
• Import what already exists: Bring a whole workspace or single resources under Git control, with secrets scaffolded as variable references.
• Validate before you apply: Rule-based validation for v1 specs, with JSON diagnostics for CI and secrets masked in output.

Get started

1. Install Rudder CLI with the one-line installer: curl -fsSL https://github.com/rudderlabs/rudder-iac/releases/latest/download/install.sh | sh
2. Authenticate the CLI with a workspace access token.
3. Import your existing workspace, or set up a new project.
4. Validate locally, then run rudder-cli apply to sync your workspace.

See the Installation guide for platform-specific steps.

Resources

• Rudder CLI Overview: Supported resource types and workflows
• CLI Commands Reference: Every command and flag
• Migration Guide: Moving a project from rudder/0.1 to rudder/v1
• Validations: The rules applied before an apply
• Variable Substitution: Keeping secrets out of Git