+ Connectors — Cai Docs

Connectors

Connectors let Cai create issues and tickets in external services, directly from whatever you select. Select an error, press Option+C, and create a GitHub or Linear issue in seconds.

GitHub

1. Create a Personal Access Token

GitHub offers two token types. Pick whichever fits your needs:

  • Fine-grained token — per-repo scoped, more granular control. Best if you want Cai to only see specific repositories.
  • Classic token — broader access, quicker setup. Best if you want Cai to work across all your repos and orgs automatically.

Option A: Fine-grained token

  1. Go to GitHub Token Settings
  2. Click Generate new token → Fine-grained token
  3. Set Token name (e.g., “Cai”)
  4. Under Repository access, select Only select repositories and pick the repos you want Cai to create issues in
  5. Under Permissions → Repository permissions, set Issues to Read and write
  6. Click Generate token and copy it

GitHub fine-grained token setup

Option B: Classic token

  1. Go to GitHub Token Settings (Classic)
  2. Click Generate new token → Generate new token (classic)
  3. Set Note (e.g., “Cai”) and choose an expiration
  4. Enable these scopes:
    • repo — full repository access. Needed for creating issues, commenting, adding labels, and searching private repos.
    • read:org — under admin:org → write:org → read:org. Needed so Cai can detect the orgs you belong to.
  5. Click Generate token and copy it

Classic tokens automatically see every org and repo you have access to — no per-repo selection needed.

2. Add to Cai

  1. Open Cai → Settings → Connectors
  2. Expand GitHub and paste your token (ghp_... for classic, github_pat_... for fine-grained)
  3. Click Save, then Test Connection

You’re all set. “Create GitHub Issue” will now appear in your action list when you press Option+C.

Privacy: Your token is stored in macOS Keychain, never in config files or sent anywhere except GitHub’s API.

Linear

1. Create an API Key

  1. Go to Linear API Key Settings
  2. Set Label (e.g., “Cai”)
  3. Set Permission to Read & Write
  4. Set Team access to All teams you have access to
  5. Click Create and copy the key

Linear API key setup

2. Add to Cai

  1. Open Cai → Settings → Connectors
  2. Expand Linear and paste your API key (lin_api_...)
  3. Click Save, then Test Connection

You’re all set. “Create Linear Issue” will now appear in your action list when you press Option+C.

Privacy: Your API key is stored in macOS Keychain, never in config files or sent anywhere except Linear’s API.