Skip to main content
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
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.

​
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

1

Open Settings → Integrations

In Knoq, click your avatar in the top-right corner, select Settings, then choose Integrations from the left sidebar.
2

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.
3

Click Connect

Click the Linear card and press Connect. Knoq redirects you to Linear’s OAuth authorization page.
4

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.
5

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.
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.

​
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 doWhat Knoq cannot do
Read issues, projects, and cyclesCreate or edit issues
Read team and member metadataChange issue status or priority
Read roadmap and milestone dataDelete issues or projects
Read comments and activityModify workspace settings
Read label and priority metadataAdd or remove team members
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.
The number of integrations you can connect is determined by your Knoq plan. Linear counts as one connector against your limit. See concepts for full plan details.