CLI Overview

Robin supports a CLI-first workflow for local AI agents and human operators.

The robin CLI is a thin wrapper over the HTTP API. Its job is to make common workflows easier, not to invent a separate business contract.

For exact command examples, see Commands. For agent-oriented operating guidance, see Agents.

Common Loop

Most workflows follow the same shape: authenticate, inspect state, discover markets, quote, optionally execute, then verify with trade history.

Command Areas

• Setup: robin auth set-key, robin auth show, robin auth clear
• Reads: robin me, robin markets, robin trades
• Quotes: robin quote-buy, robin quote-sell
• Execution: robin buy, robin sell

Ordering And Limits

Commands that support --limit return the first N items from the API’s default ordering. For robin trades, that means the newest trade feed items first. Confirmed executions and pending submissions can appear in the same feed when --include-pending-by-me is used.

Principles

• Prefer --json for automation and agent use.
• Keep command semantics aligned with API semantics.
• Keep field names consistent with the HTTP API where practical.