Skip to main content
Administrators connect Linear to Cake Agents once for the whole organization. After setup, sessions can read Linear issues and projects and post progress back as comments.

​
What this enables

Connecting Linear allows Cake Agents to:
  • read issues, projects, and status
  • comment on issues with session progress
  • move issues when a pull request is opened or merged
  • start a Cake session automatically when a user invokes the Cake agent on a Linear issue

​
How Linear-triggered sessions work

Once the integration is configured, invoking the Cake agent on an issue in Linear creates a new Cake session. The session is titled after the issue (for example, [ENG-123] Fix login redirect) and is owned by the Linear user who triggered it. Cake replies once in the Linear agent session with a link to the new Cake session, and the rest of the conversation happens in Cake Agents rather than in Linear. The Linear user must already exist in Cake Agents with the same email address. If no matching Cake user is found, the session is not created. Ask users to sign in to Cake Agents at least once before invoking the agent from Linear.

​
Admin responsibilities

As an admin, you are responsible for:
  • creating an OAuth application in your Linear workspace
  • pasting the Client ID, Client Secret, and Webhook Secret Linear generates into Cake Agents
  • installing Cake Agents into your Linear workspace
  • keeping the credentials up to date if you rotate them

​
Requirements

You must be a Linear workspace admin to create the OAuth application.

​
Instructions

​
Create the OAuth app in Linear

  1. In Cake Agents, go to Settings → Organization → Integrations.
  2. Next to Linear, select Configure.
  3. In the dialog, select Create app in Linear. This opens Linear’s new-application page with your callback URL and webhook URL prefilled from a manifest — you do not need to copy them by hand.
  4. In Linear, review the app details and create the application.
  5. Linear returns a Client ID, Client Secret, and Webhook Secret on the app’s settings page. The Webhook Secret is what Cake Agents uses to verify incoming Linear webhook requests, so make sure to copy it before leaving the page.

​
Save the credentials in Cake Agents

  1. Return to the Connect Linear dialog in Cake Agents. This is the Configure step of the setup wizard.
  2. Paste the Client ID into the Client ID field.
  3. Paste the Client Secret into the Client Secret field.
  4. Paste the Webhook Secret into the Webhook Secret field.
  5. Select Save and continue.
Saving new credentials replaces any previous values.

​
Install Cake Agents in your Linear workspace

Saving credentials moves the wizard to the Install step. This step connects a Linear workspace to Cake Agents so the app can act on issues.
  1. On the Install step, select Install Cake Agents in Linear. Linear opens in a new tab and asks you to authorize the app for your workspace.
  2. Review the requested permissions (read issues and projects, assignable to issues) and approve the installation in Linear.
  3. Return to Cake Agents. The dialog shows Linear workspace connected with the workspace URL and the profile Cake Agents installed as.
  4. Select Done to close the dialog.
Only one Linear workspace can be connected at a time. To connect a different workspace, install Cake Agents from that workspace using the same button — the previous installation is replaced.

​
Rotate or update credentials

To rotate a secret or point Cake Agents at a different Linear application:
  1. Generate a new Client Secret or Webhook Secret in Linear (or create a new application).
  2. In Cake Agents, go to Settings → Organization → Integrations and select Configure next to Linear.
  3. On the Configure step, enter the Client ID, Client Secret, and Webhook Secret, then select Save and continue.
  4. If you switched to a different Linear application, reinstall Cake Agents on the Install step.