Connectors

Connectors let Cai create issues and tickets in external services — directly from your clipboard. Copy an error, press Option+C, and create a GitHub or Linear issue in seconds.

GitHub

1. Create a Personal Access 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

2. Add to Cai

1. Open Cai → Settings → Connectors
2. Expand GitHub and paste your token (ghp_...)
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

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.