Skip to content

skillett connect

Terminal window
skillett connect <integration>

Initiates an OAuth 2.0 authorization flow for the specified integration. Opens your browser to the service’s consent screen, then polls until authorization completes.

No flags. The integration slug is a required positional argument.

StepEndpoint
Start connectionPOST /v1/connect
Poll statusGET /v1/connect/:connectionId (every 3s, 5min timeout)
Terminal window
$ skillett connect github
Opening browser for GitHub authorization...
Waiting for authorization...
{ "status": "connected", "integration": "github" }

Connection count is limited by your plan:

PlanMax connections
Free3
Pro10
UnlimitedUnlimited

If you’ve reached your limit:

{
"error": "plan_limit_reached",
"message": "Plan limit reached: maximum 3 connections. Upgrade your plan for more.",
"action_url": "https://app.skillett.dev/billing"
}
  • 0 — Successfully connected
  • 1 — Authorization denied, plan limit reached, or invalid integration
  • 2 — Network error or timeout (5 minutes)