The resolido command-line tool – every API operation from the terminal, built for people, scripts and coding agents.

npx resolido login
npx resolido whoami
npx resolido conversations list --view escalated

The CLI builds its commands from the OpenAPI spec, so every API operation is available as resolido <group> <command> the day it ships.

resolido login

Opens the Resolido consent page, where you pick the organization and access level. Tokens are stored in ~/.config/resolido/credentials.json (readable only by you) and refreshed automatically. Use --no-browser on remote machines to print the link instead, and --profile <name> to keep several organizations side by side (resolido profiles, resolido use <name>). resolido logout revokes the session.

Commands

resolido help                                  # all groups
resolido conversations                         # commands in a group
resolido conversations reply --help            # flags of a command

resolido conversations get chat_k17…
resolido conversations reply chat_k17… --text "Your parcel left today." --then resolve
resolido agents test k17… --message "Do you ship to Slovakia?"
resolido knowledge create --type url --url https://shop.example/faq --agent-ids k17…
resolido skills create --data @order-status-skill.json
resolido stats overview --json

Path parameters are positional; everything else is a --kebab-case flag. Arrays take a,b,c, objects take JSON, and --data <json|@file|-> sends a whole body (flags override its fields).
resolido api <METHOD> <path> calls any endpoint directly, e.g. resolido api GET "/conversations?view=snoozed".

Output

In a terminal, lists are printed as tables. When stdout is not a terminal – a pipe, a script or a coding agent – output is JSON. --json forces JSON everywhere; errors go to stderr as JSON with the API's code and hint.

resolido conversations list --view escalated --json | jq '.data[].id'

Safety

Destructive commands (deleting agents, knowledge, members, mailboxes…) print a summary and ask Continue? [y/N]. In non-interactive runs they exit with code 5 until you add --yes – an agent should only add it after you agreed.
Customer-facing commands (replies, emails, invitations) are sent with an Idempotency-Key, so automatic retries never message a customer twice.

Exit codes

Code	Meaning
0	Success
1	Unexpected error
2	Invalid usage or input
3	Not signed in or missing permission
4	Not found
5	Confirmation required
6	Rate limited
7	`resolido test`: at least one test failed

Agent tests

resolido test runs YAML scenarios against an AI agent and checks replies, tools, escalations and plain-language criteria with an AI judge. See Testing agents.

MCP bridge and skill

resolido mcp runs a local stdio MCP server that forwards to the remote one – for clients without remote MCP support. It accepts --toolsets and --readonly like the MCP server.
resolido skill install installs the agent skill.

Environment variables

Variable	Default
`RESOLIDO_API_KEY`	–
`RESOLIDO_PROFILE`	current profile
`RESOLIDO_API_URL`	`https://api.resolido.com/v1`
`RESOLIDO_AUTH_URL`	`https://www.resolido.com`
`RESOLIDO_MCP_URL`	`https://mcp.resolido.com/mcp`

CLI

Sign inCopy link to this section

CommandsCopy link to this section

OutputCopy link to this section

SafetyCopy link to this section

Exit codesCopy link to this section

Agent testsCopy link to this section

MCP bridge and skillCopy link to this section

Environment variablesCopy link to this section

On this page

Sign in