CLI — Agents

The rivano agents subcommands let you inspect and manage deployed agents from your terminal without opening the dashboard.

List agents

rivano agents list

Output:

NAME                   ENVIRONMENT    MODEL              PROVIDER    DEPLOYED
contract-summarizer    production     gpt-4o             openai      2 hours ago
support-classifier     production     claude-3-5-sonnet  anthropic   1 day ago
code-reviewer          staging        gpt-4-turbo        openai      3 days ago

Use --json for structured output:

rivano agents list --json
{
  "data": [
    {
      "id": "agent_abc123",
      "name": "contract-summarizer",
      "environment": "production",
      "modelProvider": "openai",
      "modelName": "gpt-4o",
      "createdAt": "2026-04-04T10:00:00Z"
    }
  ],
  "total": 3
}

Get an agent

rivano agents get contract-summarizer

Output:

Agent: contract-summarizer
─────────────────────────────────────
ID:            agent_abc123
Environment:   production
Provider:      openai
Model:         gpt-4o
Description:   Summarizes legal contracts for review teams
Created:       2026-04-02T08:00:00Z
Updated:       2026-04-04T10:00:00Z
Version:       v3

Config YAML:
  agents:
    - name: contract-summarizer
      modelProvider: openai
      modelName: gpt-4o
      environment: production

View deployment history

rivano agents history contract-summarizer

Output:

VERSION    DEPLOYED BY            DEPLOYED AT              CHANGE
v3         you@example.com        2026-04-04T10:00:00Z     Model updated to gpt-4o
v2         alice@example.com      2026-04-02T14:30:00Z     Description updated
v1         you@example.com        2026-04-01T09:00:00Z     Initial deployment

Roll back an agent

Roll back to the previous version:

rivano agents rollback contract-summarizer
# ✔ Rolled back contract-summarizer to v2
⚠

Rolling back redeploys the previous configuration but does not undo trace data or policy changes that occurred between versions.

Roll back to a specific version:

rivano agents rollback contract-summarizer --version v1
# ✔ Rolled back contract-summarizer to v1

Using —json for scripting

All agent commands support --json. This makes them composable with jq:

# Get all agent names
rivano agents list --json | jq -r '.data[].name'

# Check if a specific agent exists
rivano agents get contract-summarizer --json | jq '.id'

# Get the current version
rivano agents get contract-summarizer --json | jq -r '.version'
Previous ← CLI Overview Next CLI — Policies →