Linear

Issue tracking over GraphQL: issues, projects, cycles, comments and teams.

API keyCopy Anchor Link

1. In Linear, open Settings → Account → Security & access.
2. Under Personal API keys, select New API key. Limit it to the permissions and teams the app needs.
3. Copy the key. It's shown once.

Add it to your Gateway. It asks for the key:

everyapp provider add linear

Use it in an appCopy Anchor Link

In the app's everyapp.config.ts:

capabilities: {
  linear: { access: "read", why: "What the app does with it." },
},

The app calls Linear's API with integrationFetch(), and the Gateway adds the key. Use "write" if the app changes things. More in API providers.

Check it worked: everyapp provider show linear shows the key as set.

Rate limits: 2,500 requests and 3,000,000 complexity points an hour per API key.

Connect accountsCopy Anchor Link

Each person connects their own Linear account in the Gateway, once, and every app that asks uses it. Apps never see the tokens. How connecting works

The redirect URI to register, with your Gateway's address (like apps.example.com):

https://<your gateway>/connect/linear-oauth/callback

1. Open Settings → API → OAuth applications in your Linear workspace and create a new application.
2. Add the redirect URI above as a callback URL.
3. Save, then copy the Client ID and Client secret.

Add it to your Gateway. It asks for the client ID and secret:

everyapp provider add linear-oauth

Or add it in Manage workspace → Providers.

Use it in an appCopy Anchor Link

capabilities: {
  "linear-oauth": { access: "write", scopes: ["workspace.write"], why: "What the app does with it." },
},

Apps ask for these scope sets:

Check it worked: everyapp provider show linear-oauth shows the client as set. Then open the account menu → Connected accounts → Connect Linear.

Something wrong or missing? Open an issue.