Prerequisites
- A Linear workspace with admin access
- An active LaunchSafe workspace
Setup
1
Navigate to Integrations
In the LaunchSafe dashboard, go to Integrations in the sidebar and locate the Linear card.
2
Connect Linear
Click Connect Linear. You’ll be redirected to Linear’s OAuth authorization page.
3
Authorize LaunchSafe
Grant LaunchSafe access to your Linear workspace. LaunchSafe requests permission to:
- Read teams and projects
- Create, read, and update issues
- Add comments and attachments
4
Select your team
Choose the Linear team where security issues should be created. You can also configure:
- Default project — assign issues to a specific project (e.g., “Security Backlog”)
- Labels — automatically apply labels like
securityorvulnerability - Cycle — optionally assign issues to the current cycle
Creating issues from findings
From any finding in LaunchSafe:- Click the Create Linear Issue button on the finding detail page
- Review the pre-populated fields
- Optionally adjust team, project, assignee, or cycle
- Click Create — the issue is created in Linear
- A link to the Linear issue appears on the finding
Field mapping
Priority mapping
Why Linear works well for security issues
Linear’s workflow model aligns naturally with vulnerability remediation:- Triage → finding discovered, issue created, awaiting review
- Backlog → finding reviewed, prioritized for a future cycle
- In Progress → developer actively working on the fix
- Done → fix deployed, verified by rescan
Bulk issue creation
Select multiple findings from the Findings page and create Linear issues in bulk. Each finding becomes a separate issue in your configured team, with appropriate priority and labels applied.Issue tracking
Once a Linear issue is created from a finding, LaunchSafe tracks the association:- The finding shows a Linear issue link for quick navigation
- Duplicate issue creation is prevented (you’ll see a warning if an issue already exists)
- When you rescan and the vulnerability is resolved, the finding is marked as fixed — you can close the Linear issue