Skip to main content
The Linear integration makes delivery status available in your client work. Ask what is still open in the current cycle, which issues in a client project are blocked, or what the team said on an issue since Monday, and Hebno answers from Linear with each issue cited. When a request implies a change, such as raising an issue or moving one to Done, Hebno shows a confirmation card and writes to Linear only after you confirm.

​
At a glance

​
Before you start

You need:
  • A Linear account in the workspace you want to use.
  • An allowed integration. An owner or admin sets Linear to Allow under Admin → Connectors → Catalogue.
  • Approval from a Linear workspace admin if your workspace requires admin approval before members authorise applications.
Hebno requests these OAuth scopes: Hebno does not request the admin scope, so it cannot change workspace, team or integration settings.

​
Connect Linear

1

Start the connection

Open Settings → Connections, find Linear and select Connect. You can also select Connect from the prompt in a chat.
2

Sign in to Linear

Sign in, choose the workspace if you belong to more than one, check the access Hebno requests, and select Authorize.
3

Return to Hebno

The card shows Connected with your workspace name.
Hebno reads and writes with your own permissions, so you see only the teams you can open in Linear, including private teams you are a member of. Tokens are encrypted at rest. Select Disconnect at any time, or ask an admin to revoke the connection under Admin → Connectors → Connections.

​
What Hebno reads

Hebno queries Linear through its GraphQL API and filters by team, project, cycle, status and assignee for you, so you can ask in plain words rather than build a filter. Reads are live. Hebno queries Linear when a request needs it. Only what a reply used is stored with the conversation as its sources.
Excerpts a reply uses become part of the conversation. Anyone you share the conversation with can read them, including issue descriptions and comments from Linear.

​
What Hebno writes

Every write appears first as a confirmation card. You can change any field before you select Confirm.
Confirmation card for Linear with editable fields

A Linear change pending confirmation. Nothing is written until you confirm.

Hebno never deletes or archives issues, projects or cycles, changes team membership or workflow states, or edits workspace settings. Writes are made as your Linear user, so Linear shows you as the creator or author. Linking marks which Linear projects belong to an engagement, so you can ask “what is blocked?” without naming the project.
  1. Open the project and select Brain.
  2. Under Linked records, select Link record, then Linear.
  3. Search by project name and select it. Repeat for each Linear project in the engagement.
In chats tagged to the project, Hebno starts with the linked Linear projects for any delivery question, and cards for new issues default to them. See Linked records.

​
Use Linear in chat

  • Attach: open the + menu, choose Sources → Linear, and pick a project, a cycle or an issue. Or type / and choose Linear.
  • Ask: name the issue identifier, project, cycle or person in your request. For example:
    List every open issue in the Contoso pricing review project with priority Urgent or High, grouped by assignee.
    Summarise what the Analytics team completed in the last cycle and what rolled over.
    Move ANA-218 to In Review, assign it to Sarah Chen and add a comment that the rerun used the November store data.
  • Research runs show a Checking Linear step, with a chip for each project, cycle and issue it read.
  • Agents can read Linear on a schedule, for example a Friday summary of the cycle with issues at risk of rolling over. Writes an agent proposes appear in agent approvals for review.

​
Troubleshooting