Linear
Connect Linear to the AI agent: issues, projects, teams, cycles, labels and workflow states
Connect Linear to the AI agent: issues, projects, teams, cycles, labels and workflow states. The agent files issues and reports on the current cycle.
DocumentationЗакрыто 34 issue из 52, до конца цикла четыре дня.
- 7 issue в In Progress не меняли статус больше пяти дней
- половина оставшегося скоупа — на одном инженере, 9 issue с приоритетом Urgent
Что переносим в следующий цикл?
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.
How to connect
Open Settings → “Security & access”
In Linear click your workspace avatar → Settings → “Security & access”. Personal keys live in your account settings, not in the workspace-wide integration pages.
Create the key under “Personal API keys”
In the “Personal API keys” block click “New API key” and give it a name. No button means an admin disabled “Member API keys” in Settings → Administration → API — ask them to enable it or issue the key for you.
Grant the key the scope the agent needs
Pick full access or a restricted set: Read, Write, Admin, Create issues, Create comments. Without Write the agent is read-only — it cannot create an issue or move its status. Access can also be limited to specific teams.
Copy the key at once — it is shown only once
The key starts with lin_api_. Linear reveals it a single time: close the dialog and you will have to issue a new one. Copy the whole string, prefix included, and keep it at hand.
What the agent does in the first 10 minutes
- Shows the state of the current cycle: which issues are stalled and who on the team is carrying the most
- Creates and updates issues from your plain description — team, project, labels and workflow status are filled in for you
- Sends a project digest at the time you agree on and reacts to new issues and comments the moment they appear
FAQ
How do I connect Linear?
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.
What does the agent see in Linear?
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.
Does the agent write to Linear?
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.
Why is there no button to create a key in settings?
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.
