# Agents

> Status: Beta

> For the complete documentation index, see [llms.txt](https://developer.rippling.com/llms.txt). Every page is available as Markdown by adding .md to its URL.

> Closed beta. Run agent evaluations, install skills, and search guidance using the Rippling CLI.

Source: https://developer.rippling.com/documentation/rippling-platform/rippling-cli/agents

> **Rippling:**
> 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.

| Flag | Type | Required | Environment | Description |
| --- | --- | --- | --- | --- |
| `--agent-api-name` | string | no | `RIPPLING_EVAL_AGENT_ID`, plus shared variables | ACP Agent `api_name`. Required when the manifest contains multiple ACP Agents. |
| `--evals-dir` | string | no | `RIPPLING_EVAL_TEST_GLOB`, plus shared variables | Eval directory relative to the package root. Default `src/evals`. |
| `--judge-model` | string | no | `RIPPLING_EVAL_JUDGE_MODEL`, `RIPPLING_EVAL_LLM_GATEWAY_API_KEY`, plus shared variables | Model used by LLM Gateway judges. Default `gpt-5-mini`. |
| `--timeout` | duration | no | `RIPPLING_EVAL_AGENT_TIMEOUT_MS`, plus shared variables | Maximum deployment and per-agent-run wait. Default 5 minutes. |
| `--output-file` | string | no | Shared only | Optional path for Vitest JSON results. |

*Example:*

```bash
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.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `--host` | string | no | `claude-code`, `cursor`, or `codex`. Default is all hosts. |
| `--force` | boolean | no | Overwrite existing files without prompting. |
| `--dry-run` | boolean | no | Print the changes without writing them. |
| `--skills-dir` | string | no | Local `skills/core` directory (dev). |

*Example:*

```bash
rippling skills install
rippling skills install --host cursor
```

## Search

### `rippling search`

Searches local commands, examples, and project guidance.

| Flag | Type | Required | Description |
| --- | --- | --- | --- |
| `<query>` | string | yes | Words to find. This is a positional argument, not a flag. |
| `--json` | boolean | no | Print matching references as JSON. |

*Example:*

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