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

# Linear

> Connect Linear to CloudThinker to search issues, projects, and cycles, surface blocked work, and draft approval-gated updates

Connect your Linear workspace to let CloudThinker agents search issues, projects, cycles, teams, comments, and status changes, and surface what is blocked or needs attention next.

Linear uses **OAuth**, so you do not need to create a Linear API key or paste credentials into CloudThinker. Updates to work items stay deliberate actions that wait for your [approval](/guide/approval).

## Prerequisites

* A **Linear account** with access to the teams and projects you want CloudThinker to work with.
* Permission to authorize CloudThinker through Linear's OAuth flow.

## Setup

<Steps>
  <Step title="Open CloudThinker">
    Navigate to **Connections → Linear** in your CloudThinker workspace.
  </Step>

  <Step title="Start the OAuth flow">
    Click **Connect** to open Linear's authorization page.
  </Step>

  <Step title="Authorize CloudThinker">
    Sign in to the Linear account with access to the right workspace, then approve access.
  </Step>

  <Step title="Return to CloudThinker">
    After authorization, CloudThinker stores the OAuth tokens and shows a **Connected** status.
  </Step>
</Steps>

## Connection details

Linear uses OAuth — there are no connection fields to enter manually.

| Field            | Description                                                         |
| ---------------- | ------------------------------------------------------------------- |
| **OAuth tokens** | Issued by Linear and stored automatically; no manual entry required |

## Required permissions

CloudThinker inherits the Linear access granted during OAuth — agents see the teams, projects, and issues the authorizing account can see.

* **Read operations** include searching issues, projects, cycles, teams, comments, and status history.
* **Updates** to issues and other work items are gated by [approval](/guide/approval) in CloudThinker.

## Agent capabilities

Once connected, agents can:

| Capability                   | Description                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------ |
| **Issue search**             | Search issues across teams and projects, including comments and status changes |
| **Project and cycle review** | Review project and cycle progress to see what is on or off track               |
| **Blocked-work detection**   | Surface work that is blocked, stale, or waiting on someone                     |
| **Approval-gated updates**   | Draft issue updates that apply only after you approve them                     |

### Verify the connection

```text theme={null}
@anna list my Linear teams and summarize the current cycle's progress
```

### Example prompts

```text theme={null}
@anna #report blocked or overdue issues in the current Linear cycle
@anna #report the status of open Linear issues mentioning the checkout service
@anna #recommend a priority order for the unassigned Linear issues in the platform team
```

## Troubleshooting

<Accordion title="OAuth flow does not complete">
  Your browser may be signed in to the wrong Linear account, or not signed in at all. Sign in to the intended account and retry the connection flow from **Connections → Linear**.
</Accordion>

<Accordion title="Agent cannot find expected teams or issues">
  The OAuth flow was completed with an account that lacks access to those teams. Reconnect using a Linear account with the right team membership.
</Accordion>

<Accordion title="Connection worked, then stopped">
  The authorization may have been revoked in Linear. Remove the connection in CloudThinker and run the OAuth flow again.
</Accordion>

## Security

* **Least privilege** — grant only the permissions the agents need for your use case; start read-only and widen later.
* **Read-only by default** — use read-only credentials unless you want agents to make changes through this connection.
* **Rotate credentials** — rotate keys and tokens on your normal schedule; CloudThinker picks up the new value when you update the connection.
* **Revoke on offboarding** — remove the credential at the provider when you delete a connection or a teammate leaves.

- **Approval for updates** — changes to Linear work items wait for explicit approval in CloudThinker.
- **Scope by account** — the connection sees exactly what the authorizing Linear account sees.

## Related

<CardGroup cols={2}>
  <Card title="Asana Connection" icon="https://mintcdn.com/cloudthinker/klMm0ZWpWwwbjnVT/images/icons/asana.svg?fit=max&auto=format&n=klMm0ZWpWwwbjnVT&q=85&s=93c0cc45a2ea5a2fb13a67850b5cfcaf" href="/guide/connections/asana" width="24" height="24" data-path="images/icons/asana.svg">
    Project and task management
  </Card>

  <Card title="ClickUp Connection" icon="https://mintcdn.com/cloudthinker/PAPf7dQXz6G9xwkG/images/icons/clickup.svg?fit=max&auto=format&n=PAPf7dQXz6G9xwkG&q=85&s=8e9e0217c2af1d206b29dd480b884b8e" href="/guide/connections/clickup" width="24" height="24" data-path="images/icons/clickup.svg">
    Workspace and task tracking
  </Card>
</CardGroup>