> ## 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 your CodeAnt AI dashboard at [app.codeant.ai](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.
</Note>

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

### 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](/control_center/linear/create_tickets) 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

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>