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

# Connect Linear for AI-powered project tracking queries

> Connect Linear to Knoq to search issues, cycles, projects, and team roadmaps through natural language questions.

Linear keeps your engineering team's work organized — issues are triaged into cycles, projects roll up into roadmaps, and every status change is tracked. Connecting Linear to Knoq puts all of that at your fingertips in plain language. Instead of filtering views and switching contexts, you can ask what's blocking a release, check your cycle progress, or see what the growth team is working on — and get a direct, synthesized answer.

## What Knoq can access

Knoq reads from your Linear workspace using secure OAuth, scoped to the teams and workspaces your account belongs to:

* **Issues** — titles, descriptions, status, priority, labels, assignees, and comments
* **Projects** — project goals, milestones, status updates, and associated issues
* **Cycles** — active and past cycles, their contents, completion percentages, and team assignments
* **Team members** — names, roles, and issue assignments across teams you belong to
* **Roadmaps** — project timelines, target dates, and roadmap-level priorities
* **Labels, priorities, and issue relationships** — parent issues, sub-issues, and blocking relationships

<Info>
  Knoq queries Linear in real time using Linear's official API. Issue data is not indexed or cached — every query reflects the live state of your workspace, including status changes made seconds ago.
</Info>

### What Knoq cannot access

* Workspaces or teams you are not a member of
* Private team data beyond what your Linear account's permissions allow
* Billing information, API key management, or workspace admin settings

## Connect Linear

<Steps>
  <Step title="Open Settings → Integrations">
    In Knoq, click your avatar in the top-right corner, select **Settings**, then choose **Integrations** from the left sidebar.
  </Step>

  <Step title="Find the Linear connector">
    Locate the **Linear** card in the gallery. Use the **Project** category chip at the top of the gallery to filter the list.
  </Step>

  <Step title="Click Connect">
    Click the Linear card and press **Connect**. Knoq redirects you to Linear's OAuth authorization page.
  </Step>

  <Step title="Authorize Knoq on Linear">
    Linear shows the permissions Knoq is requesting — read access to your workspace data. Click **Authorize** to grant access. You'll be redirected immediately back to Knoq.
  </Step>

  <Step title="Confirm the connection">
    The Linear card on the **Settings → Integrations** page now shows a green **Connected** badge. Navigate to the Knoq chat and try your first Linear query.
  </Step>
</Steps>

<Tip>
  After connecting, try asking "What's in my current cycle?" to verify the integration is working. You should see a summary of your active cycle's issues returned in the chat.
</Tip>

## Example queries

Once Linear is connected, you can ask Knoq questions like these directly in the chat:

```
What's in my cycle this week?
```

```
Summarize open issues for the Growth team
```

```
Find the issue about the login regression reported last Monday
```

```
Which issues are marked as urgent and unassigned?
```

```
What's the current status of the mobile app project?
```

```
Show me all issues blocking the next release
```

```
How many issues did the backend team close last cycle?
```

```
What's on the roadmap for Q2?
```

Knoq synthesizes a plain-language answer from the relevant Linear data and links to the specific issues or projects it referenced.

## Permissions

Knoq requests **read-only** access to your Linear workspace. It can search and summarize your data but cannot create, modify, or delete any Linear content without your explicit instruction.

| What Knoq can do                  | What Knoq cannot do             |
| --------------------------------- | ------------------------------- |
| Read issues, projects, and cycles | Create or edit issues           |
| Read team and member metadata     | Change issue status or priority |
| Read roadmap and milestone data   | Delete issues or projects       |
| Read comments and activity        | Modify workspace settings       |
| Read label and priority metadata  | Add or remove team members      |

<Warning>
  Knoq will never create, update, or delete issues, cycles, or projects in your Linear workspace without your explicit confirmation. Write actions in Linear are not currently available through Knoq's standard search integration.
</Warning>

<Note>
  The number of integrations you can connect is determined by your Knoq plan. Linear counts as one connector against your limit. See [concepts](/concepts) for full plan details.
</Note>