Connect Linear
Link your Linear workspace to pull issue context into reviews, trigger the agent from comments, and track work end-to-end.
Linear integration connects your project management workflow with Paragon. When connected, PR reviews automatically include linked Linear issue context, and you can trigger the agent directly from Linear comments.
Only team admins can connect or disconnect Linear for the workspace.
Connect Linear
- Go to app.paragon.run and open Settings
- Scroll to the Linear section and click Connect
- Select your Linear workspace and authorize Paragon
- Choose a default Linear team for issue creation
- You'll be redirected back to the dashboard with the connection confirmed
Paragon requests the following Linear scopes: read, write, issues:create, comments:create.
How issues are linked
Paragon automatically detects Linear issues linked to a pull request using two methods:
| Method | Example |
|---|---|
| Branch name | A branch named eng-123-fix-login links to issue ENG-123 |
| PR body | Text like Fixes ENG-123 or Closes TEAM-456 in the PR description |
| Linear GitHub integration | Issues linked via Linear's native GitHub sidebar attachment |
Issue identifiers follow the pattern TEAM-123 (1-10 letter prefix, dash, number). All three methods are checked and results are deduplicated.
What Linear enables
| Feature | Description |
|---|---|
| PR Review Context | Linked issue title, description, status, and priority are included in every review |
| Agent from Linear | Mention @paragon-run in a Linear comment to trigger an agent session |
| Issue Tracking | The agent posts progress updates and results back to the Linear issue |
| Automation Triggers | Linear comment events can trigger configured automations |
| General Chat | Mention @paragon-run on any issue for conversational help, even without a linked repo |
Triggering the agent from Linear
Mention @paragon-run followed by an instruction in any Linear issue comment:
@paragon-run fix the bug described in this issue
@paragon-run add unit tests for the auth module
@paragon-run review the linked PR for security issues
The agent will:
- Acknowledge the request with a "Working on it..." comment and a link to the dashboard
- Resolve the linked GitHub repository from PR attachments, the comment body, the issue branch name, or your team's configured repos
- Clone the repo, execute the task, and post results back to the Linear issue
If no GitHub repo is linked, the agent runs in general mode -- responding conversationally, answering questions, and suggesting which repo to target.
Default team
After connecting, select a default Linear team from the dropdown in settings. This determines which team is used when Paragon creates issues from planner tasks or maps work back to Linear.
Disconnecting Linear
Go to Settings in the dashboard and click Disconnect next to the connected workspace. This removes the access token and stops all Linear-based features.
Next steps
Connect Slack
Add Slack for agent triggering, notifications, and plan approvals.
Automations
Set up automated workflows triggered by GitHub events, Slack messages, and Linear comments.