> ## 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.

# integrations

Connect, configure, and disconnect third-party integrations.

# `rogeriq integrations`

Drives the [v1 integrations API](/api/integrations/list). Supports Slack,
Discord, Shopify, Stripe, Linear, GitHub, and any other provider in the
catalog.

**list**

```bash
    rogeriq integrations list
    ```

    Installed integrations on the active project.

  **catalog**

```bash
    rogeriq integrations catalog [--q stripe] [--category commerce] [--status active]
    ```

    Browse all available integrations with their install state, health,
    and most recent sync.

  **get**

```bash
    rogeriq integrations get slack
    ```

    Catalog detail for one provider, including install state.

  **connect**

```bash
    rogeriq integrations connect slack
    ```

    Returns a dashboard URL to open in your browser to complete OAuth.
    OAuth handshakes cannot happen headlessly — the CLI hands the URL
    back rather than redirecting. Requires `write` (or
    `integrations:write`) scope.

  **lifecycle**

```bash
    rogeriq integrations lifecycle slack --status paused
    rogeriq integrations lifecycle shopify --sidebar true --display-name "Acme Store"
    rogeriq integrations lifecycle stripe --settings '{"refunds_enabled":true}'
    ```

    Update status, display name, sidebar visibility, settings, or action
    permissions for an installed integration.

    | Flag | Effect |
    |------|--------|
    | `--status active\|paused\|disconnected` | Lifecycle state |
    | `--display-name "..."` | Override the catalog name |
    | `--sidebar true\|false` | Show / hide in the inbox sidebar |
    | `--settings '{...}'` | Merge provider-specific settings JSON |

  **disconnect**

```bash
    rogeriq integrations disconnect slack
    ```

    Sets the integration to `disconnected`, hides the sidebar, and clears
    health status.

## Common workflows

### Pause integrations during maintenance

```bash
for p in slack shopify stripe; do
  rogeriq integrations lifecycle "$p" --status paused
done

# Resume:
for p in slack shopify stripe; do
  rogeriq integrations lifecycle "$p" --status active
done
```

### Audit which integrations are healthy

```bash
rogeriq integrations list --json | jq '.[] | select(.health_status != "healthy")'
```