CLI quickstart

bash
npm install -g @rogeriq/cli# or:  brew install rogeriq/tap/rogeriq

bash
rogeriq auth login

bash
rogeriq projects listrogeriq projects use prj_xxxxxxxxxxxx

bash
rogeriq conversations list --status openrogeriq conversations get con_xxxxxxxxxxxxrogeriq conversations reply con_xxxxxxxxxxxx "Thanks — looking into this now."rogeriq conversations resolve con_xxxxxxxxxxxx

bash
rogeriq agent respond con_xxxxxxxxxxxx

Common workflows

Search the knowledge base before replying

bash
rogeriq kb search "refund policy"

Ingest a docs site into the KB

bash
rogeriq kb crawl https://docs.example.comrogeriq kb crawl status crawl_xxx

Customize the chat widget

bash
rogeriq widget configrogeriq widget set --theme dark --primary-color '#5b21b6'

Subscribe to webhooks

bash
rogeriq webhooks create \  --url https://your-app.com/rogeriq-hook \  --events 'conversation.*,message.created'rogeriq webhooks test wh_xxxxx     # fire a sample eventrogeriq webhooks deliveries wh_xxxxx

Pipe IDs through a shell loop

bash
# Resolve every conversation an agent classified as low-priorityfor id in $(rogeriq conversations list --status open --priority low --quiet); do  rogeriq conversations resolve "$id"done

Output

• Defaults to a human-readable table when stdout is a TTY.
• Defaults to JSON when stdout is piped — agent/jq-friendly.
• Force JSON with --json. Print only IDs with --quiet.

bash
rogeriq conversations list --status open --json | jq '.[].id'

Project switching

Most commands operate against a single project. Three ways to pick one:

bash
# 1. Set the default (saved in ~/.rogeriq/config.json)rogeriq projects use prj_xxx# 2. Override per shell sessionexport RIQ_PROJECT_ID=prj_xxx# 3. Override per commandrogeriq conversations list --project prj_xxx

Help

bash
rogeriq --help                       # top-levelrogeriq <group> --help               # subcommand listrogeriq <group> <subcommand> --help  # flags + examples

What's next