Linear

Держите цикл Linear под контролем прямо из чата

Подключите Linear к ИИ-агенту: issue, проекты, команды, циклы, лейблы и статусы. Агент заведёт issue, сменит статус и соберёт сводку по циклу.

Как агент работает с Linear

Агент работает с Linear через один GraphQL-эндпоинт api.linear.app/graphql: там же issue, проекты, команды, циклы, лейблы, комментарии, workflow-статусы и участники. Запрос перечисляет нужные поля явно, поэтому за состоянием цикла агент идёт одним обращением, а не собирает картину из десятка выгрузок: что стоит без движения, что просрочено, на кого из команды навешано больше всего.

Важная особенность Linear — workflow-статусы принадлежат командам, а не воркспейсу: у каждой команды свой набор состояний со своими названиями, и одинаково подписанные колонки в двух командах остаются двумя разными статусами. Поэтому агент сначала определяет команду issue и только потом подбирает статус из её набора, а не переносит задачу в состояние соседней команды по совпадению названия.

На запись агент заводит issue в нужной команде и проекте, проставляет лейблы, приоритет и workflow-статус, пишет комментарии и убирает issue в архив — но только если у ключа есть право Write. Ключ без него читает и считает, и об этом агент скажет заранее, а не будет молча упираться в отказ. После изменения он перечитывает issue, чтобы показать её фактическое состояние, а не отправленный запрос.

Границы видимого задаёт сам ключ: если при выпуске доступ сужен до конкретных команд, остальной воркспейс агенту виден не будет, и разговор идёт только о них. Длинные выборки Linear отдаёт страницами по курсору, поэтому список issue агент дочитывает до конца, а не обрывает на первой сотне. Частоту запросов он выдерживает сам, о новых issue и комментариях узнаёт вебхуками, а при нехватке прав говорит прямо, а не показывает пустую таблицу.

Сценарии интеграции

Состояние текущего цикла

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

Issue из обсуждения

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

Сводка по проектам

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

Реакция на новые issue

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

Что на мне на этой неделе

Агент соберёт issue, назначенные на вас во всех доступных командах, разложит их по приоритету и сроку и скажет, что горит сегодня, а что подождёт.

Разбор необработанных issue

Агент найдёт issue без ответственного, лейбла или цикла, покажет их одним списком и, если у ключа есть право Write, проставит лейблы и приоритет.

Примеры: Linear

Linear
Реальные диалоги — выберите вопрос
Как идёт текущий цикл?

Закрыто 34 issue из 52, до конца цикла четыре дня.

  • 7 issue в In Progress не меняли статус больше пяти дней
  • половина оставшегося скоупа — на одном инженере, 9 issue с приоритетом Urgent

Что переносим в следующий цикл?

Текущий цикл

ГруппаIssue
Всего в цикле52
Закрыто34
В In Progress без движения дольше пяти дней7
С приоритетом Urgent на одном инженере9
Ответить...

Ассистент может ошибаться — проверяйте его работу

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

Перед подключением

  • Аккаунт участника воркспейса Linear
  • Настройка «Member API keys» включена администратором
  • Роль администратора, если ключу нужен доступ Admin
  1. 1

    Откройте Settings → «Security & access»

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

  2. 2

    Создайте ключ в «Personal API keys»

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

  3. 3

    Выдайте ключу права под задачи агента

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

  4. 4

    Скопируйте ключ — он показан один раз

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

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

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

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

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

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

Похожие интеграции

Подключение
По API-ключу
Документация
Linear

Подключите Linear

Зарегистрируйтесь — подключение занимает пару минут, данные остаются в ваших системах.

Попробовать бесплатно