> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amplify.security/llms.txt
> Use this file to discover all available pages before exploring further.

# Linear

> Agents create, update, comment on, and transition Linear issues in every team the bot account belongs to.

## What it's for

Tracking findings as Linear issues. A workflow step files an issue per confirmed finding in the right team;
a chat agent checks whether something is already tracked, adds what it learned as a comment, or moves an
issue to the next state once a fix is verified.

## Before you connect

1. Create the bot Linear user. See [the bot account](/integrations/connecting#the-bot-account).
2. Add it to every team agents should file into. Linear has no picker at authorization — the connection
   reaches **every team the bot account belongs to**, so team membership is the only scoping lever.
3. Sign your browser into the bot account, then follow [the connect flow](/integrations/connecting#connecting).

The authorization screen asks for read and write access to the bot account's workspace, plus permission to
create comments.

## What agents can do

| Tool | What it does |
| - | - |
| `Linear_WhoAmI` | Returns the bot account's profile and team memberships. |
| `Linear_ListTeams` | Lists teams, optionally filtered by keyword. |
| `Linear_GetTeam` | Returns one team in detail. |
| `Linear_ListProjects` | Lists projects, filterable by keyword, status, team, or creation date. |
| `Linear_GetProject` | Returns one project in detail. |
| `Linear_GetProjectDescription` | Returns a project's full description, paginated. |
| `Linear_ListIssues` | Lists issues, filterable by keyword and other criteria. |
| `Linear_GetIssue` | Returns one issue in detail. |
| `Linear_ListComments` | Reads an issue's comments. |
| `Linear_ListLabels` | Lists the workspace's labels. |
| `Linear_ListWorkflowStates` | Lists the workflow states available in the workspace. |
| `Linear_ListCycles` | Lists cycles, filterable by team and status. |
| `Linear_GetCycle` | Returns one cycle in detail. |
| `Linear_CreateIssue` | Creates an issue. Team, assignee, labels, state, project, cycle, and parent are validated first, with suggestions if one isn't found. |
| `Linear_UpdateIssue` | Updates an issue's title, description, assignee, labels, priority, or estimate. |
| `Linear_TransitionIssueState` | Moves an issue to a new workflow state. |
| `Linear_AddComment` | Comments on an issue. |
| `Linear_ReplyToComment` | Replies to an existing comment. |
| `Linear_CreateIssueRelation` | Relates two issues — blocks, duplicates, related. |
| `Linear_CreateLabel` | Creates a label and optionally applies it. |

Agents are instructed to create issues only for findings you asked to track, never in bulk. Status changes
go through `Linear_TransitionIssueState`, not `Linear_UpdateIssue`. An issue created without an assignee is
assigned to the bot account, which is Linear's behavior for the authenticated user.

## What agents can't do

* Delete, archive, or trash anything
* Create or edit projects, initiatives, documents, milestones, or project statuses
* Attach files or manage subscriptions
* Reach a team the bot account isn't a member of

## Example

Ask in chat, with Linear connected:

```
Is finding #17 already tracked in the Platform team? Search open issues for the
file path. If not, create one labeled "security" with the finding's summary and
a link back here, and leave it in Triage.
```

For a workflow step that files one issue per finding, adapt the
[Jira example](/integrations/using-in-agents#one-issue-per-finding): swap the tools for `Linear_ListTeams`,
`Linear_ListIssues`, and `Linear_CreateIssue`, and name the team instead of a project key.

## Revoking fully

Disconnecting in Console deletes Amplify's stored authorization. To remove Linear's side of the grant too,
sign in as the bot account and revoke Amplify Console under
**Settings → Security & access → Authorized applications**.


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