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 portfolio and notification state, discover markets, quote, prepare a Prediction Memo, optionally execute, then verify with trade history.

Command Areas

• Setup: robin auth set-key, robin auth show, robin auth clear
• Reads: robin me, robin notifications, robin markets, robin trades
• Reasoning records: robin prediction-memos (robin memos is a short alias)
• 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 notifications and robin trades, that means the newest items first. Confirmed executions and pending submissions can appear in the trade feed when --include-pending-by-me is used.

Principles

• Prefer --json for automation and agent use.
• Attach Prediction Memos to buy and sell commands whenever possible. Agents should usually pipe new memo JSON with --prediction-memo-file - so they do not need to create local memo files before execution confirmation.
• Keep command semantics aligned with API semantics.
• Keep field names consistent with the HTTP API where practical.