Skip to main content

🔌 Connect the agent to Linear

Let the AI agent find, summarise and update issues in Linear.

Written by Yoki Kahsay

Linear is where many teams keep track of issues and projects. Connect Linear to the AI agent in Cobrief and the agent can find issues, summarise status, and create or update issues straight from a conversation.

The connector is available on paid plans. You connect with your own Linear account, and the agent only gets access to what you can already see and do. You use the connector through the agent, so you need the administrator or member role. Contributors don't have access to the agent. Read more about roles and permissions.

What the agent can do

  • Search issues, projects and teams you have access to.

  • Read descriptions and comments.

  • Create new issues and update existing ones.

  • Leave comments.

Linear decides which tools are available. You can see the list on the integration card once you have connected.

How to connect

  1. Go to "Settings" → "Integrations".

  2. Find Linear under "Personal" and click "Connect".

  3. Sign in to Linear and approve access.

  4. When you return to Cobrief, you can see which account is connected.

Connecting from the settings turns the connector on for new conversations. Conversations you have already started keep their current setting. You can also connect from the "Connectors" menu inside a conversation. That turns the connector on for that conversation.

Use Linear in a conversation

Open the "Connectors" menu in the agent and turn Linear on for the conversation. For example, you can ask the agent to:

  • "Find open Linear issues assigned to me."

  • "Summarise what the team shipped this week."

  • "Create a Linear issue about updating our reference list."

Choose what the agent may do

The tools from Linear fall into two groups: those that only read, and those that can change or delete something. By default the agent may read freely, while anything that changes something needs your approval in the conversation. The agent shows you what it wants to do, and you choose "Approve" or "Reject".

Administrators can change this for the whole workspace under "Settings" → "Integrations" → Linear. Each group and each individual tool can be set to "Always allow", "Needs approval" or "Blocked". Other users can see the settings but cannot change them.

Disconnect or reconnect

Go to "Settings" → "Integrations", find Linear and click "Disconnect". The agent then loses access to your Linear account. You can connect again whenever you like.

If access expires or is revoked, Cobrief shows "Requires new sign-in". Click "Reconnect" to continue.

Security

The agent uses your own sign-in with Linear and never reaches further than you do yourself. Content is fetched while the agent works, and we don't keep a copy of your Linear data. Answers and documents the agent produces are stored in Cobrief as usual.

Read more about how we work with security and privacy in our Trust Center.

Can't connect?

  • If you belong to several Linear workspaces, the one you sign in to is the one that gets connected. To switch, disconnect and connect again.

  • If you don't see Linear under "Integrations", check that your workspace is on a paid plan and that you have the administrator or member role.

Did this answer your question?