Linear — управление задачами, проектами и работой с Codex

Linear помогает продуктовой и инженерной команде связать задачи, проекты, циклы разработки и входящие запросы. Это руководство показывает, как организовать такой процесс и подключить Codex для чтения задач или выполнения работы в облаке.

Сведения проверены по официальным источникам 19 октября 2026 года. Подключение Linear, Codex и API в рамках этой редакционной проверки не выполнялось. Тарифы и права доступа перед внедрением нужно сверить для своего рабочего пространства.

Что это такое

Linear — облачная система управления задачами и проектами. Отдельная задача хранит описание работы, статус и ответственного; проекты объединяют задачи, а инициативы связывают проекты общей целью. Входящие обращения сначала можно разобрать в очереди Triage и затем включить в план команды.

Сначала проверьте эту модель на одном реальном проекте. Пилот покажет, хватает ли вам структуры Linear, настроек доступа и нужных интеграций.

Как устроена работа в Linear

У задач есть подзадачи и связи, в том числе блокировка, зависимость, связь по теме и дубликат. У инициатив можно задавать статус, приоритет, метки, ответственного и ведущую команду. Инициатива собирает выбранные проекты вокруг цели; представление собирает работу по фильтрам. Документация инициатив.

Основные возможности

Linear поддерживает интеграции с GitHub, GitLab, Figma, Sentry, Slack и сервисами поддержки. Например, GitHub связывает задачи с pull request, а Zendesk и Intercom помогают передавать обращения в разработку. Набор интеграций и условия подключения сверяйте с официальным каталогом.

Cycles: планирование итераций

Цикл задаёт повторяющийся период работы команды и сам по себе не означает выпуск версии. Длительность настраивается от 1 до 8 недель; Linear создаёт будущие циклы по расписанию, максимум 15. Между циклами можно оставить паузу для планирования и технического долга — cooldown.

Незавершённые задачи закрывающегося цикла обычно переходят в следующий. Задачи, перемещённые в Backlog, Triage, Canceled или Completed во время паузы, не переносятся. Незавершённую задачу нельзя сохранить в закрытом цикле: обновляйте её состояние до завершения периода, если важна историческая отчётность.

Оценка вместимости будущего цикла опирается на объём работы трёх предыдущих завершённых циклов. Без такой истории она приблизительно рассчитывается по числу участников. Это ориентир для планирования, который нужно сопоставлять с доступностью команды. Правила Cycles.

Triage: обработка входящих задач

Triage — входящая очередь команды. В неё обычно попадают задачи от интеграций и участников других команд; шаблон может переопределить начальный статус. Очередь позволяет принять задачу в рабочий процесс, отклонить, объединить с существующей как дубликат или отложить до выбранного времени либо новой активности.

На Business и Enterprise доступны Triage Rules, Triage Intelligence и Triage Responsibility. Правила меняют команду, статус, исполнителя, метки, проект и приоритет. Triage Intelligence предлагает свойства и возможные дубликаты по содержанию задачи. Ответственного можно назначить вручную или связать ротацию с PagerDuty, OpsGenie, Rootly либо Incident.io. Документация Triage.

API и подключение интеграций

Linear предоставляет GraphQL API по адресу https://api.linear.app/graphql, вебхуки и официальный TypeScript SDK. Для приложения, которое подключают разные пользователи, используйте OAuth 2.0. Для контролируемого внутреннего сценария подходит персональный API-ключ. У этих способов различается заголовок авторизации: OAuth использует Bearer, персональный ключ передаётся напрямую. Начало работы с API.

Ключ получите в настройках безопасности своего аккаунта Linear. Передайте его локальному процессу через LINEAR_API_KEY, используя принятый у вас способ хранения секретов. Пример ниже только читает идентификатор текущего пользователя:

curl --fail-with-body --silent --show-error \
  https://api.linear.app/graphql \
  -H "Authorization: ${LINEAR_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data '{"query":"{ viewer { id } }"}'

Признак успешного подключения: в JSON есть непустой data.viewer.id и нет errors. Одного HTTP-ответа для проверки недостаточно. Не отправляйте ключ в переписку и не сохраняйте его в репозиторий.

Официальный SDK устанавливается командой:

npm install @linear/sdk

Он поддерживает персональный API-ключ и OAuth-токен. Примеры клиента и запросов находятся в документации SDK.

Для получения изменений используйте вебхуки. Ограничивайте выборку фильтрами и явно задавайте пагинацию, чтобы не загружать лишние данные. Эти рекомендации и правила обработки ограничений приведены в документации лимитов.

Лимиты GraphQL API

Максимальная сложность одного запроса — 10 000 баллов. У отдельных операций есть более строгие ограничения. Несколько персональных ключей одного пользователя делят его квоту. Лимит не предоставляет доступ к данным: для защищённых объектов нужна авторизация. Проверено 19 октября 2026 года. Текущие лимиты.

ИИ-функции и агенты

Агентная платформа Linear включает Linear Agent, сессии работы с кодом, Triage Intelligence и Loops. Linear Agent может работать с задачами и подключёнными инструментами; сессии работы с кодом используют среду проекта. Loops запускают повторяемую агентную работу по расписанию или событию.

Loops и сессии работы с кодом доступны на платных планах и расходуют кредиты ИИ (AI credits). На странице тарифов Loops указаны в составе Business, поэтому доступность проверьте в своём рабочем пространстве.

Кредиты подключаются добровольно и пополняются заранее, минимум на $10; купленные кредиты сгорают через 12 месяцев. Типичный запуск Loop без сессии работы с кодом стоит $0,07–0,20. Сессия оплачивается по токенам модели и времени среды выполнения — $0,25 за каждые 20 минут. До включения определите разрешённые действия и задайте лимиты расхода. Наличие агента в тарифе не означает, что любой его запуск бесплатен. Тарифы Linear, кредиты ИИ.

Два способа подключить OpenAI Codex

Облачный Codex внутри задачи Linear

Облачная интеграция запускает агентную сессию, когда задачу назначают на Codex или упоминают @Codex. Агент публикует обновления в Linear и оставляет ссылку на завершённую задачу Codex cloud для проверки, продолжения работы или подготовки pull request.

На дату проверки интеграция перечислена для ChatGPT Plus, Pro, Business, Enterprise и Edu. Порядок подключения:

1. Подключите нужный GitHub-аккаунт в Codex.
2. Подготовьте облачное окружение для репозитория.
3. Установите агента Codex в рабочее пространство Linear через настройки Codex.
4. Передайте хорошо описанную задачу через назначение или @Codex.

В Enterprise администратору может потребоваться разрешить облачные задачи и коннектор Codex for Linear. Если окружений несколько, укажите нужное в комментарии. Готовый результат требует проверки перед созданием и слиянием pull request. Интеграция Codex в Linear.

Codex CLI и расширение для IDE через Linear MCP

MCP — протокол, через который агент получает инструменты внешней системы. Linear предоставляет удалённый сервер со Streamable HTTP. Стандартный адрес https://mcp.linear.app/mcp по умолчанию допускает чтение и запись. Адрес https://mcp.linear.app/mcp/readonly предоставляет только инструменты чтения. Ещё один вариант — запросить только OAuth scope read на стандартном адресе. Вместо интерактивного OAuth-входа можно передать API-ключ или OAuth-токен в заголовке Authorization: Bearer; ключ только с правом Read даёт доступ на чтение. Права и подключение Linear MCP.

Подключение через Codex CLI

Сначала проверьте существующие подключения:

codex mcp list

Если подходящего подключения нет, добавьте вариант для чтения:

codex mcp add linear-readonly --url https://mcp.linear.app/mcp/readonly

Пройдите предложенный OAuth-вход. Если он не открылся, запустите его отдельно:

codex mcp login linear-readonly

Ручная конфигурация

Вместо команды добавления можно настроить тот же сервер в активной конфигурации Codex, обычно ~/.codex/config.toml:

[mcp_servers.linear-readonly]
# Для поиска задач и подготовки сводок достаточно чтения.
url = "https://mcp.linear.app/mcp/readonly"

После ручной настройки выполните OAuth-вход для этого имени сервера. CLI, расширение для IDE и десктопное приложение ChatGPT используют общую конфигурацию. Поддержка и команды MCP описаны в документации OpenAI.

Тарифы и ограничения

Проверено по странице тарифов 19 октября 2026 года. Basic и Business ниже указаны при годовой оплате.

Состав планов, стоимость и условия кредитов ИИ могут меняться. До оплаты проверьте ограничения нужного сценария в своём рабочем пространстве.

Полезные сценарии

Управление работой продуктовой команды

Задача: связать ежедневную работу с целью. Условие: есть команда и один проект для пилота.

Создайте инициативу, включите проект, разложите его на задачи и выберите работу ближайшего цикла. Результат: у активной задачи видны исполнитель, проект и цикл, а проект связан с инициативой. Если необходимы нестандартные согласования, проверьте их на пилоте до переноса всей команды.

Приём запросов от поддержки и других команд

Задача: разбирать входящие обращения до включения в план. Условие: доступна нужная интеграция и назначен ответственный.

Включите Triage и отправьте тестовое обращение. Проверьте его свойства, затем примите задачу в процесс команды. На подходящем тарифе добавьте правила маршрутизации. Результат: обращение проходит ожидаемый маршрут, не попадая в запланированную работу до решения ответственного. Проверьте шаблоны: они могут менять начальный статус.

Собственная интеграция через API

Задача: связать Linear с внутренним сервисом. Условие: выбран способ авторизации и доступен обработчик вебхука.

Начните с читающего запроса, затем подключите вебхук на нужные события. После разрешённого изменения тестовой сущности проверьте получение события и его обработку. Результат: приложение читает нужные данные и реагирует на изменение. Дополнительно проверьте повторные события и ошибки; успешное чтение API не доказывает работу вебхука.

Разобрать задачу из Linear в локальной сессии

Задача: получить требования перед изменением кода. Условие: подключён MCP для чтения и доступна нужная задача.

Промпт:

Открой issue AIL-123, перечисли требования, ограничения и неизвестные детали. Ничего в Linear не изменяй.

Замените AIL-123 идентификатором своей задачи. Результат: агент передаёт содержание задачи и отдельно называет пробелы; заголовок и статус совпадают с Linear. Для этого сценария права записи не нужны.

Создать задачу из контекста кода

Задача: перенести обнаруженную работу в трекер. Условие: заранее выбраны команда или проект; создание разрешено и доступен MCP с правом записи.

Промпт:

Подготовь задачу для проекта X: добавь контекст, ожидаемое поведение, критерии готовности и способ проверки. Перед созданием покажи черновик.

Замените X проектом. После подтверждения проверьте команду, проект, заголовок и описание созданной задачи. Подключение /mcp/readonly этот сценарий не выполняет.

Делегировать хорошо описанную задачу облачному Codex

Задача: выполнить ограниченную работу с репозиторием. Условие: подключены GitHub, облачное окружение и агент Codex.

Добавьте в задачу результат, команду проверки и границы изменений, затем передайте её Codex. Результат: в Linear появляются обновления и ссылка на облачную сессию; по ссылке доступны изменения и результаты проверок. Сводка агента не заменяет ревью и не подтверждает выпуск в production.

Формат задачи для работы с агентом

Укажите контекст репозитория и файлов, ожидаемое поведение, способ проверки и границы изменений. Для перехода от идеи к постановке можно использовать процесс «Идея → PRD → Dev Kickoff».

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

Проверка результата подключения MCP

1. Примените конфигурацию способом, который предусмотрен вашим клиентом, и выполните OAuth-вход.
2. Попросите найти известную задачу по идентификатору.
3. Сравните заголовок и статус с интерфейсом Linear.
4. Для /mcp/readonly проверьте, что доступны только инструменты чтения.
5. Если нужен доступ на запись, после отдельного разрешения проверьте его на тестовой задаче и прочитайте результат обратно.

Как проверить результат

Для командного процесса создайте тестовую задачу, назначьте исполнителя, проект и цикл, затем проверьте её в представлениях. Отдельно проведите обращение через Triage. Если используется API, проверьте содержимое ответа; если вебхук — получение и обработку события. Для работы Codex просмотрите изменения и результаты команд проверки.

Успешный признак зависит от маршрута: задача правильно связана с проектом, обращение принято из очереди, интеграция получила событие или агент вернул проверяемое изменение. Настройку каждого используемого маршрута проверяйте отдельно.

Когда Linear подходит команде

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

Ограничения и выбор инструмента

До миграции проверьте роли и доступ, нестандартные согласования, перенос истории, нужную отчётность, интеграции и расход кредитов ИИ. Если эти требования не укладываются в модель Linear, сравните альтернативы. Материалы о команде из трёх ИИ-агентов и навыке ведущего разработчика помогут определить роль человека и порядок передачи работы агентам.

Официальные ссылки

• Linear и каталог интеграций
• Документация Linear
• API и SDK
• Тарифы
• Журнал изменений
• Состояние сервисов

Следующий шаг

Если нужен другой подход к управлению проектами, сравните Linear с Plane — платформой с открытым исходным кодом.

Если вы собираете процесс разработки с Linear и Codex, полезно заранее определить, какие задачи получает агент, какой доступ ему нужен и как команда принимает результат.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov