Connect Your Account

In this page, you'll link the CLI to your Supyagent dashboard account so it can access your connected integrations.

Run the connect command

supyagent connect

You'll see something like this:

╭──────────────────────────────────────╮
│                                      │
│   Your code:  ABCD1234               │
│                                      │
╰──────────────────────────────────────╯

Opening browser to https://app.supyagent.com/device...

Waiting for authorization...

What happens next

1. Your browser opens automatically to the Supyagent authorization page
2. You'll see the code shown in your terminal (e.g., ABCD1234) — verify it matches
3. Click Approve in the browser
4. The CLI detects the approval and stores your API key locally

Back in your terminal, you'll see:

✓ Connected!

Connected Integrations
┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Provider ┃ Services                          ┃
┡━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ google   │ gmail, calendar, drive            │
│ slack    │ general                           │
└──────────┴───────────────────────────────────┘

The integrations listed match what you connected on your dashboard.

Verify the connection

Run the status command to confirm everything is working:

supyagent status

You should see:

Connected to https://app.supyagent.com
Service is reachable

Available Service Tools
┏━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┓
┃ Provider ┃ Service  ┃ Tools ┃
┡━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━┩
│ google   │ gmail    │ 5     │
│ google   │ calendar │ 4     │
│ google   │ drive    │ 4     │
│ slack    │ general  │ 4     │
└──────────┴──────────┴───────┘

17 tools total

The tools listed here are what you can call from the CLI and what your AI coding assistant will have access to.

Alternative: manual API key setup

If you already have an API key from the dashboard (from the Create Your Account step), you can set it manually instead of using the device flow:

supyagent config set SUPYAGENT_API_KEY
# Paste your sk_live_... key when prompted

Troubleshooting

Browser didn't open

Copy the URL shown in the terminal and paste it into your browser manually.

Timed out waiting for authorization

The device flow has a timeout. Run supyagent connect again to get a new code.

Service is not reachable

Check your internet connection. If you're behind a corporate firewall or VPN, make sure app.supyagent.com is accessible.

Next step

Your First API Call — Run a cloud tool and see the results.