CLI Overview

Package: @robertoagent/cli
Binary: roberto

Install

Run without global install:

yarn dlx @robertoagent/cli help

Or install globally:

npm install -g @robertoagent/cli

Core Commands

• roberto help
• roberto version
• roberto capabilities
• roberto mcp
• roberto auth <subcommand>
• roberto agents <subcommand>
• roberto billing <subcommand>
• roberto task <subcommand>

Control Plane URL

The CLI targets your configured Roberto control plane URL. You can override it per command:

roberto auth status --control-plane-url https://<your-control-plane>

Auth Store Paths

• User auth store default: ~/.config/roberto/auth.json
• Runtime auth store default: /data/.roberto/runtime-auth.json

Current Scope

The CLI currently focuses on:

• Device-flow user auth lifecycle
• Runtime bootstrap and refresh lifecycle
• Runtime update check/apply/report workflow
• Runtime delegation lifecycle (list/create/revoke)
• Agent lifecycle and channel operations (list/create/update/delete/provision/start/stop/status/clone/channel connect)
• Billing flows (status/summary/usage/checkout/credits/portal/sync + runtime request approvals + standing spend policy controls)
• Dashboard-equivalent action dispatch via roberto task run
• MCP server handoff (roberto mcp)

Use the command reference for endpoint-level behavior and flags.