> ## 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.

# Setup

> Connect your Linear workspace to CodeAnt AI

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.

***

## 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 the [CodeAnt AI dashboard](https://app.codeant.ai).
* Navigate to **Settings > Integrations > Linear**.

You'll see a card prompting you to connect your Linear workspace.

### 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.

> [!NOTE]
>
> 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.

Click **Save** to apply the selection. You can change the team or project at any time from the same page.

> [!NOTE]
>
> 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](https://docs.codeant.ai/control_center/linear/create_tickets.md) 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 |

CodeAnt AI does **not** read your existing issues, comments, or attachments, and never modifies tickets it didn't create.

***

## 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 |

This means high‑severity findings show up at the top of your Linear inbox without any extra triage.

***

## 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

> [accordion] 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.

> [accordion] 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.

> [accordion] 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.

> [accordion] 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.

> [accordion] 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.