First Integration

Connect Quox to Slack, GitHub, or SSH.

Connect Quox to an external service to unlock more capabilities. Integrations are configured through the dashboard settings or via n8n workflow nodes.

Integration	Method	What You Get
SSH Host	QuoxBastion or QuoxAgent	Remote command execution, fleet management
Slack	n8n Slack node	Alert notifications, workflow outputs
GitHub	n8n GitHub node	Issue/PR notifications, CI/CD triggers

Option A: Slack (Recommended)

Best for: Teams who want alerts and approvals in their existing communication tool.

1. Create Slack App

Go to api.slack.com/apps
Click Create New App → From manifest
Select your workspace
Paste this manifest:

yaml

display_information:
  name: Quox
  description: AI Infrastructure Assistant
  background_color: "#0a0a0f"
features:
  bot_user:
    display_name: Quox
    always_online: true
  slash_commands:
    - command: /quox
      url: https://YOUR_QUOX_DOMAIN/api/slack/command
      description: Talk to Quox
      usage_hint: "[your question or command]"
oauth_config:
  scopes:
    bot:
      - chat:write
      - chat:write.public
      - channels:read
      - commands
      - users:read
settings:
  interactivity:
    is_enabled: true
    request_url: https://YOUR_QUOX_DOMAIN/api/slack/interactive
  event_subscriptions:
    request_url: https://YOUR_QUOX_DOMAIN/api/slack/events
    bot_events:
      - message.im

Click Create
Go to Install App → Install to Workspace
Copy the Bot User OAuth Token (starts with xoxb-)

2. Configure in Quox

In the Quox dashboard:

You: configure slack integration

Quox: I'll help you set up Slack. I need:

      1. Bot User OAuth Token (starts with xoxb-)

      Paste your token:

You: xoxb-1234567890-1234567890123-abcdefghijklmnop

Quox: ✓ Token validated
      ✓ Connected to workspace: YourCompany
      ✓ Bot user: @quox

      Testing connection...
      ✓ Sent test message to #general

      Slack integration active! I can now:
      • Send alerts to any public channel
      • Receive commands via /quox
      • Request approvals via DM
      • Post workflow results

      Default alert channel: #general
      [Change Default Channel]

3. Test It

You: send a test alert to #ops-alerts

Quox: ✓ Sent to #ops-alerts:

      "🔔 Test alert from Quox - integration working!"

In Slack, try:

/quox what's the status of nw-web-01?

4. Configure Alert Routing (Optional)

You: configure slack alerts

Quox: Current alert routing:

      | Alert Type     | Channel       |
      |----------------|---------------|
      | Critical       | #ops-critical |
      | Warning        | #ops-alerts   |
      | Info           | #ops-general  |
      | Approval       | DM to user    |

      [Edit Routing] [Test Each Channel]

Option B: GitHub

Best for: Teams who want to manage issues, PRs, and trigger CI/CD from Quox.

1. Create Personal Access Token

Go to GitHub → Settings → Developer settings
Click Personal access tokens → Tokens (classic)
Click Generate new token (classic)
Select scopes:
- repo (Full control of private repositories)
- workflow (Update GitHub Action workflows)
Click Generate token
Copy the token (starts with ghp_)

2. Configure in Quox

You: configure github integration

Quox: I'll set up GitHub access. I need your Personal Access Token.

      Required scopes: repo, workflow

      Paste your token:

You: ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Quox: ✓ Token validated
      ✓ Authenticated as: @yourusername
      ✓ Found 23 accessible repositories

      GitHub integration active! I can now:
      • List and search repositories
      • Create and manage issues
      • Review and comment on PRs
      • Trigger GitHub Actions
      • Monitor repository activity

      [Set Default Repository] [View Repositories]

3. Test It

You: list open issues in acme/infrastructure

Quox: Found 7 open issues in acme/infrastructure:

      #142 🔴 Production DB latency spike (2 hours ago)
           Labels: bug, priority-high
           Assignee: @alice

      #141 🟡 Update Terraform to 1.6 (1 day ago)
           Labels: enhancement, terraform
           Assignee: unassigned

      #138 🟢 Add monitoring for new service (3 days ago)
           Labels: enhancement
           Assignee: @bob

      [View All] [Create Issue] [Filter by Label]

You: assign issue 141 to me and add comment that I'm starting work

Quox: ✓ Assigned #141 to @yourusername
      ✓ Added comment:
        "Starting work on Terraform 1.6 upgrade. Will update when complete."

      Want me to create a branch for this work?

Option C: SSH Host

Best for: Hosts where you can't install QuoxAgent (restricted access, ephemeral instances).

1. Add SSH Host

You: add ssh host devbox at 10.20.0.50

Quox: I'll set up SSH access to devbox (10.20.0.50).

      Connection options:
      1. Use existing SSH key (~/.ssh/id_rsa)
      2. Generate new key pair
      3. Use SSH agent forwarding
      4. Password authentication (not recommended)

      Which option?

You: use existing key

Quox: Using key: ~/.ssh/id_rsa
      Username: control (default)

      Testing connection to [email protected]...

2. Verify Connection

Quox: ✓ SSH connection successful!

      Host: devbox (10.20.0.50)
      OS: Ubuntu 22.04.3 LTS
      Uptime: 45 days

      devbox is now available for commands.

      💡 For better performance and features, consider
         installing QuoxAgent: `quox install quoxagent on devbox`

      [Install QuoxAgent] [Skip]

3. Use the Host

You: check memory usage on devbox

Quox: [Connecting via SSH to devbox]

      Memory usage on devbox:

                  Total     Used      Free
      RAM         16GB      12GB      4GB    (75%)
      Swap        2GB       0.5GB     1.5GB  (25%)

      Top memory consumers:
      1. java (elasticsearch)    4.2GB
      2. dockerd                 1.8GB
      3. postgres                1.2GB

SSH vs QuoxAgent Comparison

Feature	SSH	QuoxAgent
Command execution	✓	✓
Real-time metrics	✗	✓
WebSocket streaming	✗	✓
Agent session monitoring	✗	✓
Credential storage	Required	Not needed
Latency	Higher	Lower

Managing Integrations

List All Integrations

You: list my integrations

Quox: Active integrations:

      | Service  | Status    | Connected As    |
      |----------|-----------|-----------------|
      | Slack    | ✓ Active  | @quox           |
      | GitHub   | ✓ Active  | @yourusername   |
      | SSH      | ✓ 2 hosts | devbox, staging |

      [Add Integration] [Edit] [Remove]

Test Integration Health

You: test all integrations

Quox: Running integration health checks...

      ✓ Slack: Connected, can post to #ops-alerts
      ✓ GitHub: API responding, rate limit OK (4,832/5,000)
      ✓ SSH devbox: Connection OK, latency 23ms
      ✓ SSH staging: Connection OK, latency 45ms

      All integrations healthy.

Remove Integration

You: remove github integration

Quox: ⚠️ Removing GitHub will:
      • Disable issue/PR commands
      • Stop repository monitoring
      • Invalidate stored token

      Type REMOVE-GITHUB to confirm:

You: REMOVE-GITHUB

Quox: ✓ GitHub integration removed.

Next Steps

All Integrations - Browse all 413 integration types (named providers with a credential schema the vault stores and tests)
Workflows - Automate tasks with your integrations
Memory - Teach Quox about your infrastructure
Safety - Configure approval workflows for integrations