> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monocle.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Create and sync issues between Monocle and Linear

Connect your Linear workspace to Monocle so your team can create properly categorized issues directly from exceptions.

## Why Connect Linear?

When you spot an exception in Monocle, you can create a Linear issue with the full context: team, project, assignee, priority, labels, and status. Everything is pre-filled with the exception details and a link back to the Monocle dashboard.

You can also search and link existing Linear issues if the bug is already tracked.

When a linked issue is completed in Linear, Monocle automatically marks it as resolved. No manual status updates needed.

## Setup

1. Go to **Organization Settings > Integrations** and click **Connect** next to Linear.
2. Complete the OAuth flow to authorize Monocle.

Once connected, click **Configure** to map each Monocle application to a Linear team. This way, issues created from exceptions automatically land in the right team.