> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rogeriq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

From "no key" to triaging your inbox in under a minute.

# CLI quickstart

**Install**

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

```bash
    rogeriq auth login
    ```

    Opens your browser. Confirm. The CLI saves the API key locally.
  **Pick a project**

```bash
    rogeriq projects list
    rogeriq projects use prj_xxxxxxxxxxxx
    ```
  **Triage your inbox**

```bash
    rogeriq conversations list --status open
    rogeriq conversations get con_xxxxxxxxxxxx
    rogeriq conversations reply con_xxxxxxxxxxxx "Thanks — looking into this now."
    rogeriq conversations resolve con_xxxxxxxxxxxx
    ```
  **Let the AI draft a reply**

```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.com
rogeriq kb crawl status crawl_xxx
```

### Customize the chat widget

```bash
rogeriq widget config
rogeriq 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 event
rogeriq webhooks deliveries wh_xxxxx
```

### Pipe IDs through a shell loop

```bash
# Resolve every conversation an agent classified as low-priority
for 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 session
export RIQ_PROJECT_ID=prj_xxx

# 3. Override per command
rogeriq conversations list --project prj_xxx
```

## Help

```bash
rogeriq --help                       # top-level
rogeriq <group> --help               # subcommand list
rogeriq <group> <subcommand> --help  # flags + examples
```

## What's next

**[All commands](/cli/commands/conversations)**

Full command reference grouped by domain.
  **[MCP server](/cli/mcp)**

Run `rogeriq mcp` and Claude / Cursor can call the API as native tools.
  **[Agent guide](/cli/agents)**

Drive the CLI from AI agents and CI: env vars, exit codes, JSON output.
  **[SDK](/sdk/quickstart)**

For programmatic access from any TypeScript / Node project.