# Linear

Linear: задачи (issues), проекты, команды, циклы, лейблы, комментарии, workflow-статусы

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

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

[Open Linear](https://linear.app/settings/account/security)