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

# Linear

> Search, create, and update Linear issues directly from conversations.

Connect Indexbrain to Linear to search issues with real filters, and — the only write-capable integration in Indexbrain today — create issues, update them, and add comments directly from conversation.

## Setup

<Steps>
  <Step title="Go to Integrations">
    Navigate to **Settings > Integrations > Linear**.
  </Step>

  <Step title="Authorize">
    Click **Connect** and authorize Indexbrain in Linear.
  </Step>
</Steps>

<Warning>
  Linear now requests both read and write scope. If you connected Linear
  before this shipped, **reconnect** — your existing connection only has
  read access and won't be able to create issues, update them, or post
  comments until you reauthorize.
</Warning>

<Note>
  Every other Indexbrain integration is read-only by design. Linear is the
  one deliberate exception — the write actions below are real: they create,
  change, and post to your actual Linear workspace, visible to your whole
  team.
</Note>

## Capabilities

### Search and analyze issues

```
How many open bugs do we have in the ENG project?
```

Issue search resolves into real filters against Linear's API — state, team, assignee, title, and priority — not fuzzy text search over flattened issues. Filters combine with AND.

### Create new issues

```
Create an issue for adding OAuth support, priority high
```

You'll always be shown the exact title, team, and description before it's created — Indexbrain confirms with you first, then creates the real issue and gives you the link.

### Update existing issues

```
Move ENG-654 to Done
```

Updates the issue's state, title, or priority. Confirmed with you before the change is made.

### Comment on issues

```
Comment on ENG-289 that the fix is deployed
```

Posts a real, visible comment to the issue — confirmed with you first.

## What gets synced

* **Issues** — all states, including cancelled/duplicate (kept deliberately — "we tried X, cancelled it" is real decision history, not noise).
* **Comments** on each issue.
* Team, assignee, labels, priority, and workflow state.

Updates are picked up correctly — a state change, a new comment, or an edited description refreshes on the next sync rather than the item staying frozen at its first-synced state.

## How data moves

Linear syncs on your configured processing interval by default, **and** live — once the Linear webhook is registered (a one-time setup step in Linear's own workspace settings), an issue being created, updated, or commented on is picked up within about a minute instead of waiting for the next scheduled sync.

## What Indexbrain does not do in Linear (yet)

* **No projects, cycles, or roadmaps** — issues only.
* **Combined/complex filters beyond AND** — "bugs OR features" isn't supported, only ANDed conditions.
* **Bulk operations** — one issue at a time, not "close all issues tagged X."

## Troubleshooting

<AccordionGroup>
  <Accordion title="Create/update/comment actions aren't working">
    * Reconnect Linear — connections made before write access shipped only have read scope.
    * Confirm the team name or issue identifier you used matches Linear exactly.
  </Accordion>

  <Accordion title="A query returns no results">
    * Confirm the property name and value match how they appear in Linear (e.g. the exact workflow state name, the team's key like "ENG" not its full name).
  </Accordion>

  <Accordion title="An issue I updated in Linear doesn't reflect the change">
    * If the live webhook isn't registered yet, it can take up to your configured processing interval to appear.
  </Accordion>
</AccordionGroup>