Connect your Linear workspace to CodeAnt AI and turn any finding — security vulnerability, code-quality insight, or pentest issue — into a Linear ticket in one click. No copy‑paste, no context switching.Documentation Index
Fetch the complete documentation index at: https://docs.codeant.ai/llms.txt
Use this file to discover all available pages before exploring further.
How It Works
The integration uses Linear’s official OAuth 2.0 flow. You authorize CodeAnt AI from your Linear account, pick a default team (and optionally a project) for tickets to land in, and you’re done.1. Open the Linear Integration page
- Log in to your CodeAnt AI dashboard at app.codeant.ai.
- Navigate to Settings > Integrations > Linear.
2. Connect Linear
- Click Connect Linear — you’ll be redirected to Linear’s authorization screen.
- Review the permissions and choose the workspace you want to connect.
- Click Authorize to grant access.
- You’ll be redirected back to Settings > Integrations > Linear in CodeAnt AI. The card now shows your workspace name with a Connected badge.
On first connection, CodeAnt AI automatically creates a workspace‑level label called CodeAnt in your Linear workspace. Every ticket created from CodeAnt AI is auto-tagged with this label, so your team can filter and triage CodeAnt findings at a glance.
3. Choose Where Tickets Should Land
Once connected, pick the default destination for tickets created from CodeAnt AI:- Team (required) — The Linear team that will own tickets created by CodeAnt AI (e.g.
Engineering,Security). - Project (optional) — A specific project within the selected team. Leave as No project to create tickets at the team level.
Changing the project list re‑fetches when you switch teams — projects are scoped to a single team in Linear, so a stale project from a different team would misroute the ticket.
4. You’re All Set
You can now create Linear issues directly from any finding in the CodeAnt AI dashboard. See the Create Linear Issues guide for details.Permissions Requested
| Permission | Why |
|---|---|
| Read your account info | To display your workspace name and connected user |
| Read teams and projects | To let you pick where tickets should land |
| Create issues | To file tickets when you click Create Linear Issue |
| Create labels | To create the CodeAnt label so tickets are tagged automatically |
Severity → Priority Mapping
When CodeAnt AI creates a Linear ticket, the severity of the finding maps to Linear’s priority field:| CodeAnt severity | Linear priority |
|---|---|
| Critical | Urgent |
| High | High |
| Medium | Medium |
| Low | Low |
Security
- The connection uses Linear’s official OAuth 2.0 flow with cryptographically signed state parameters, so the authorization callback cannot be tampered with.
- Access tokens are encrypted at rest and in transit, and refreshed automatically before expiry.
- You can revoke access at any time by clicking Disconnect on the Linear Integration page. Disconnecting removes CodeAnt AI’s stored credentials and revokes the OAuth token in Linear.
FAQ
Do I need to be a Linear admin to connect?
Do I need to be a Linear admin to connect?
You need permission to authorize OAuth applications in your Linear workspace. Most workspaces allow any member to connect tools they use; check with your workspace admin if the Authorize button doesn’t appear for you.
Can I connect multiple Linear workspaces?
Can I connect multiple Linear workspaces?
One Linear workspace can be connected per CodeAnt AI organization. To switch workspaces, click Disconnect and then Connect Linear again — you’ll be able to choose a different workspace during the OAuth flow.
What happens if I change the selected team?
What happens if I change the selected team?
New tickets will go to the new team starting immediately. Tickets already created in the old team are not moved or modified.
Why do I see a 'CodeAnt' label in my Linear workspace?
Why do I see a 'CodeAnt' label in my Linear workspace?
CodeAnt AI creates this label automatically on first connection so every ticket it files is identifiable and filterable. The label lives at the workspace level — not on a specific team — so it can be applied to any issue. You can rename it in Linear if you prefer; CodeAnt AI tracks it by ID.
How do I disconnect?
How do I disconnect?
Click Disconnect on the Linear Integration page. CodeAnt AI deletes its stored credentials and revokes the OAuth token in Linear. You can reconnect at any time.