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

Agents

Run agent evaluations, install skills, and search guidance 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.

Evaluations​

rippling agents eval​

Deploys an ACP Agent revision and runs its evals. Run this from the project directory.

FlagTypeRequiredEnvironmentDescription
--agent-api-namestringnoRIPPLING_EVAL_AGENT_ID, plus shared variablesACP Agent api_name. Required when the manifest contains multiple ACP Agents.
--evals-dirstringnoRIPPLING_EVAL_TEST_GLOB, plus shared variablesEval directory relative to the package root. Default src/evals.
--judge-modelstringnoRIPPLING_EVAL_JUDGE_MODEL, RIPPLING_EVAL_LLM_GATEWAY_API_KEY, plus shared variablesModel used by LLM Gateway judges. Default gpt-5-mini.
--timeoutdurationnoRIPPLING_EVAL_AGENT_TIMEOUT_MS, plus shared variablesMaximum deployment and per-agent-run wait. Default 5 minutes.
--output-filestringnoShared onlyOptional path for Vitest JSON results.

Example:

rippling agents eval --agent-api-name my_agent --evals-dir src/evals --timeout 5m

Skills​

rippling skills install​

Installs or repairs Rippling core CLI skills for AI hosts.

FlagTypeRequiredDescription
--hoststringnoclaude-code, cursor, or codex. Default is all hosts.
--forcebooleannoOverwrite existing files without prompting.
--dry-runbooleannoPrint the changes without writing them.
--skills-dirstringnoLocal skills/core directory (dev).

Example:

rippling skills install
rippling skills install --host cursor

Searches local commands, examples, and project guidance.

FlagTypeRequiredDescription
<query>stringyesWords to find. This is a positional argument, not a flag.
--jsonbooleannoPrint matching references as JSON.

Example:

rippling search "package version publish"
rippling search "sandbox create" --json