Connect & Status

These commands manage the connection between your CLI and Supyagent Cloud.

supyagent connect

Authenticate your CLI with Supyagent Cloud using a device authorization flow. Opens your browser to complete login — no API key copy-pasting required.

supyagent connect

Options

What Happens

1. The CLI requests a device code from the service
2. Your browser opens to the authorization page (with a fallback URL if it can't)
3. A countdown timer shows remaining time to complete login
4. On success, the CLI stores your API key and service URL locally
5. Available integrations and tools are displayed

Example

$ supyagent connect

  Open this URL to connect:
  https://app.supyagent.com/auth/device?code=ABCD-1234

  ⏳ Waiting for authorization... (expires in 5:00)

  ✔ Connected to Supyagent Cloud
  ✔ 3 integrations active: Google, Slack, GitHub
  ✔ 47 tools available

supyagent disconnect

Remove stored credentials and unlink your CLI from Supyagent Cloud.

supyagent disconnect

This removes the locally stored API key and service URL. It does not revoke the key on the server — you can do that from the dashboard.

supyagent status

Show your current connection status, run a health check, and list available tools grouped by provider.

supyagent status

Output

Connected to: https://app.supyagent.com
Status: Healthy

Available tools:
  Google (Gmail)      — 8 tools
  Google (Calendar)   — 4 tools
  Slack               — 5 tools
  GitHub              — 6 tools

If you're not connected, it shows instructions to run supyagent connect.

supyagent doctor

Run a full diagnostic check on your CLI setup. Useful for troubleshooting connection or configuration issues.

supyagent doctor

Checks Performed

Example Output

supyagent doctor

  Version:           0.7.0
  Config encryption:  ✔ Working
  Service connection: ✔ Connected (https://app.supyagent.com)
  Health check:       ✔ Service healthy
  Tools available:    ✔ 47 tools
  Stored API keys:    2 keys configured