# Linear

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

## Сценарии

### Состояние текущего цикла
Агент покажет по циклу, какие issue стоят без движения, что просрочено и на кого из команды навешано больше всего.

### Issue из обсуждения
Агент заведёт issue в нужной команде и проекте, проставит лейблы, приоритет и workflow-статус и добавит комментарий.

### Сводка по проектам
Агент соберёт по проектам, что закрыто за неделю, что переехало дальше и какие issue висят дольше срока.

### Реакция на новые issue
Агент по вебхукам Linear отследит новые issue, правки и комментарии и сообщит о них сразу, как они появились.

## Как подключить

### Откройте Settings → «Security & access»
В Linear нажмите на аватар воркспейса → Settings → «Security & access» (раздел «Безопасность и доступ»). Кабинет Linear только на английском, русской локали нет — названия пунктов ищите как есть.

### Создайте ключ в разделе «Personal API keys»
В блоке «Personal API keys» нажмите «New API key» и дайте ключу имя. Если кнопки нет, админ воркспейса выключил «Member API keys» в Settings → Administration → API — попросите включить или выпустить ключ за вас.

### Выдайте ключу права под задачи агента
Выберите full access или ограниченный набор: Read, Write, Admin, Create issues, Create comments. Без Write агент только читает — не заведёт issue и не переведёт статус. Доступ можно сузить до конкретных команд воркспейса.

### Скопируйте ключ сразу — он показан один раз
Ключ начинается с lin_api_. Linear показывает его единожды: закроете окно — придётся выпускать новый. Скопируйте строку целиком, вместе с префиксом, и держите под рукой.

## Частые вопросы

### Как подключить Linear?
Персональным API-ключом: в Linear откройте Settings → «Security & access» → «Personal API keys» → «New API key», выдайте ключу права и скопируйте строку, которая начинается с lin_api_ — она показывается только один раз.

### Что агент видит в Linear?
Issue, проекты, команды, циклы, лейблы, комментарии, workflow-статусы и участников через GraphQL API — в пределах доступа ключа, который можно сузить до конкретных команд.

### Пишет ли агент в Linear?
Да, если у ключа есть право Write: агент создаёт и обновляет issue, меняет статусы, пишет комментарии и убирает issue в архив. Без Write доступно только чтение.

### Почему в настройках нет кнопки создания ключа?
Администратор воркспейса выключил «Member API keys» в Settings → Administration → API. Попросите включить настройку или выпустить ключ за вас.

[Открыть Linear](https://linear.app/settings/account/security)