Docs / Work tools

Linear

Connect Linear over OAuth so the agent can open, comment on, track and close issues.

Pangea connects to Linear through OAuth. You authorize once in the browser, and there is no API key to manage. The agent can then work with issues in your workspace: file a ticket for an incident it found, comment on progress, and close the issue when the fix is verified.

Connect

1. Start the authorization

As a team Administrator, open Connectors, find Linear and click Add, then click Authorize Linear. Your browser opens Linear's consent screen.

2. Approve the request

Pangea asks for read and write access. That is enough to read issues, teams and workflow states, and to create and update issues and comments.

3. Return to Pangea

Linear sends you back to the Mac app, and the connection completes by itself. There is nothing to copy and paste.

The access token is stored encrypted. Authorizing the same workspace again updates the existing connection instead of adding a duplicate.

In the Pangea app

Browse connected Linear teams and issues in Pangea, or ask an agent to search and update them. Issue details and links let you pick up work in context. The connection itself lives in Connectors, where an Administrator can manage its allow-list or remove it.

What the agent can do for you

The agent can create issues, comment on them, look up and search issues, and move them through your workflow states. It works best paired with your infrastructure connectors:

• "Investigate the elevated error rate, and file a Linear issue with what you find." The agent diagnoses through your cloud and observability connectors, then opens a ticket with the evidence.
• While it works on a fix, it comments progress on the issue. When the fix is verified, it moves the issue to Done.
• Triggers can start agents that track their work in Linear without you handling the paperwork.

Permissions and authorization

Team Administrators connect and remove this connection. They can limit it with a member allow-list. Select the connection for the conversation before you ask the agent to use it. Linear permissions stay the outer limit, whatever the prompt or permission mode.

Each action follows Auto Mode and Full Access. Significant cloud infrastructure work uses plans. A ticket, a repository write or a routine API call does not create a plan by itself. If you want to review changes before they are published, say so in your request.

Acting as yourself