For AI agents: an index of this documentation is at https://developer.rippling.com/llms.txt. Public pages have a Markdown version at the same URL with .md added.

Skip to main content
Beta

Projects & metadata

Create and deploy local projects using the Rippling CLI.

Use with AI:ChatGPT Claude Cursor

Access to the Rippling CLI is gated behind the Developer Program, which is currently in a closed beta.

Projects​

rippling project init​

Creates a project directory from a template.

FlagTypeRequiredDescription
--namestringyesName of the project directory to create.
--templatestringyesTemplate. Allowed values: agent, custom-app.

Example:

rippling project init --name my-app --template custom-app

rippling project validate​

Type-checks and executes rippling.manifest.ts, then shows the change plan. Run from the project directory after the project's Node dependencies are installed.

FlagTypeRequiredDescription
———No command-specific flags.

Example:

rippling --context sandbox-editor project validate

rippling project deploy​

Deploys the components in rippling.manifest.ts.

FlagTypeRequiredDescription
--yesbooleannoSkip the deployment confirmation prompt.
--timeoutdurationnoMaximum wait for the deployment run. Default is 5 minutes.

Example:

rippling --context sandbox-editor project deploy --yes
rippling --context sandbox-editor project deploy --yes --timeout 5m

Metadata​

rippling api metadata validate​

Runs the same manifest check as rippling project validate on the metadata API. Run from the project directory after the project's Node dependencies are installed.

FlagTypeRequiredDescription
———No command-specific flags.

Example:

rippling --context sandbox-editor api metadata validate

rippling api metadata deploy​

Deploys the components in rippling.manifest.ts through the metadata API.

FlagTypeRequiredDescription
--yesbooleannoSkip the deployment confirmation prompt.
--timeoutdurationnoMaximum wait for the deployment run. Default 5m.

Example:

rippling --context sandbox-editor api metadata deploy --yes --timeout 5m