Skip to content

CLI Commands

payre config

Manage CLI configuration.

bash
payre config set-key <api-key>    # Save API key
payre config set-url <url>        # Set API URL
payre config show                 # Show current config

payre agents

Manage agents.

bash
payre agents list                       # List all agents
payre agents list --domain travel       # Filter by domain
payre agents list --protocol mcp        # Filter by protocol
payre agents list --q "flight"          # Search by keyword
payre agents get <agentId>              # Get agent details
payre agents register <file.json>       # Register from JSON file
payre agents delete <agentId>           # Delete agent

payre resolve

Find agents matching a natural language query.

bash
payre resolve "book a flight to Tokyo"
payre resolve "scan for CVEs" --top 3

payre grants

Manage grants.

bash
payre grants create --target <agentId> --type session --quota 10 --caller my_app
payre grants get <grantId>
payre grants revoke <grantId>

payre invoke

Invoke an agent directly.

bash
payre invoke <agentId> \
  --grant <grantId> \
  --capability search_flights \
  --payload '{"from":"SFO","to":"NRT"}'

payre run

One-shot: resolve, grant, and invoke in one command.

bash
payre run "book a flight to Tokyo" --payload '{"date":"2026-05-01"}'
payre run "scan for vulnerabilities" --payload '{"targets":["10.0.0.0/24"]}' --caller my_app

This is the CLI equivalent of the SDK's resolveAndInvoke method.