Keep the current Linear cycle under control from chat
Connect Linear to the AI agent: issues, projects, teams, cycles, labels and workflow states. The agent files issues and reports on the current cycle.
How the agent works with Linear
The agent works with Linear through a single GraphQL endpoint, api.linear.app/graphql: issues, projects, teams, cycles, labels, comments, workflow states and members all live there. A query lists the fields it needs explicitly, so the agent goes after the state of a cycle in one call instead of assembling the picture from a dozen exports: what is not moving, what is overdue, who on the team is carrying the most.
An important trait of Linear is that workflow states belong to teams rather than to the workspace: every team has its own set of states with its own names, and identically labelled columns in two teams remain two different states. So the agent first works out which team an issue belongs to and only then picks a state from that team set, rather than moving the task into a neighbouring team state because the names match.
In writing, the agent files an issue in the right team and project, sets labels, priority and workflow state, posts comments and archives issues — but only if the key carries the Write permission. A key without it reads and counts, and the agent says so up front rather than quietly running into a refusal. After a change it re-reads the issue, so it shows the actual state instead of the request it sent.
What the agent can see is bounded by the key itself: when access was narrowed to specific teams at issue time, the rest of the workspace stays invisible and the answers cover those teams only. Linear returns long selections in cursor-paged chunks, so an issue list is read through to the end rather than cut off at the first hundred. The agent holds the request rate itself, learns about new issues and comments from webhooks, and when permissions fall short it says so directly instead of showing an empty table.
Integration scenarios
State of the current cycle
For the cycle the agent shows which issues are not moving, what is overdue and who on the team is carrying the most.
An issue from the discussion
The agent files an issue in the right team and project, sets labels, priority and workflow state, and adds a comment.
Project digest
Across projects the agent collects what was closed this week, what moved on and which issues have been open past their due date.
Reacting to new issues
Through Linear webhooks the agent tracks new issues, edits and comments and reports them the moment they appear.
What is on me this week
The agent collects the issues assigned to you across every team the key can reach, sorts them by priority and due date and says what is burning today.
Clearing the untriaged pile
The agent finds issues with no assignee, label or cycle, shows them as one list and, if the key carries Write, sets labels and priority on them.
Linear examples
Закрыто 34 issue из 52, до конца цикла четыре дня.
- 7 issue в In Progress не меняли статус больше пяти дней
- половина оставшегося скоупа — на одном инженере, 9 issue с приоритетом Urgent
Что переносим в следующий цикл?
Текущий цикл
Table · XLSXHow to connect
Before you connect
- A member account in the Linear workspace
- The “Member API keys” setting enabled by an admin
- Admin role if the key needs the Admin scope
- 1
In Settings open “Security & access”
In Linear click your workspace avatar → Settings → “Security & access”. Personal keys live in your account settings, not in the workspace integrations.
- 2
Create the key under “Personal API keys”
In the “Personal API keys” block click “New API key” and name it. No button means an admin disabled “Member API keys” in Settings → Administration → API.
- 3
Pick full access or a set including Write
Pick full access or a restricted set: Read, Write, Admin, Create issues, Create comments. Without Write the agent is read-only. Access can be limited to teams.
FAQ
With a personal API key: in Linear open Settings, then Security & access, then Personal API keys, then New API key, grant the key its permissions and copy the string that starts with lin_api_ — it is shown only once.
Issues, projects, teams, cycles, labels, comments, workflow states and members through the GraphQL API — within the access of the key, which can be narrowed down to specific teams.
Yes, if the key has the Write permission: the agent creates and updates issues, changes states, posts comments and archives issues. Without Write only reading is available.
The workspace admin turned off Member API keys in Settings, then Administration, then API. Ask them to enable the setting or to issue a key for you.