Linear Integration

Connect Linear teams so Brief can use issues as work context and help manage Linear work.

Last updated: October 20, 2026

Connect Linear to give Brief context from your team's issues and understand what is in progress or completed. You can also use Brief Chat to manage Linear issues and projects.

Connect Linear

  1. Open Integrations and select Connect a Tool….
  2. Choose Linear, select Done, then select Connect on its row and complete Linear authorization.
  3. Under Teams to Monitor, search for and select up to 100 teams to share, then select Complete Setup. A confirmed empty selection means Brief monitors all teams in the background, but Linear tools in Brief Chat are unavailable until you select at least one team. Don't share skips sharing during setup.

Use Configure on the Linear connection to change the selected teams later, then select Save Changes. If team selection has not been resolved, Brief pauses issue polling until it is confirmed.

What Brief uses

Brief reads Linear issues from the selected teams, including status, priority, labels, and project context. Brief uses completed work to calculate throughput, cycle time, and release cadence. This can help you ask what is in progress, what has shipped, or how much work has been completed.

After setup, Brief polls issues from the selected teams in the background. Linear webhooks can also report changes to issues, projects, and comments. An unfinished team selection pauses the issue poll.

Work with Linear in Brief

In Brief Chat, ask "Find open authentication issues in the Platform team" or "Create a bug in Platform for the failed login." Brief can search, read, create, update, archive, and delete issues; create sub-issues; list teams, projects, states, labels, members, and comments; and add comments or attachments. You can ask it to create a project or update its name, description, state, dates, lead, or health.

You can also ask Brief to relate two issues as related, blocks, blocked by, or duplicate. To remove a relationship, identify the issues so Brief can find the relation. When you ask to delete a project, Linear moves it to the trash; its issues are not deleted. Issue deletion is permanent, while archiving an issue is reversible. The connected account's permissions and the saved team selection limit which work Brief can read or change.

Common problems

  • No issues appear: Open Configure and confirm the team selection. A completed empty selection monitors all teams, while an unfinished selection pauses issue polling.
  • Linear chat actions are unavailable: If you completed setup without selecting a team, use Configure to select at least one team and save the change.
  • A team is missing from the picker: Check that the Linear account used during authorization can access that team. The picker has Search teams....
  • The wrong Linear workspace is connected: Check the workspace shown during setup and the Linear account used for authorization. Use Reconnect if you need to authorize a different account.
  • A requested change is denied: Check that the issue or project belongs to a selected team and that the connected Linear account has permission to make the change.

For more context alongside Linear, see Connect GitHub, Connect GitLab, Connect Notion, Browse integrations, and Troubleshoot connections.