Integracje / Linear
Komunikacja, projekty i biuro
Integracja AI: Linear
Podłączamy GraphQL API Linear i czytamy zgłoszenia (Issues), cykle (Cycles), projekty z kamieniami milowymi i powiązania z pull requestami. Asystent codziennie przegląda bieżący sprint, wyłapuje zablokowane i przeterminowane zgłoszenia oraz zakłada nowe Issues z maili klientów.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

W skrócie
Jak asystent AI łączy się z systemem Linear?
Łączymy się przez GraphQL API Linear. Jedno zapytanie zwraca naraz Issues z bieżącego cyklu ze wszystkimi polami, bez kilku wywołań po kolei.
- Na start potrzebujemy
- Konto Linear z dostępem do workspace'u (plan Free wystarczy do odczytu przez API)
- Czego asystent nie robi
- Nie zmienia statusów, priorytetów ani przypisań w Linear bez potwierdzenia przez człowieka.
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Linear włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyStatus, priorytet, due date, etykiety, relacje (blocked by, blocks), assignee i estimate każdego zgłoszenia w cyklu
AsystentWyłapuje zgłoszenia z przeterminowaną due date, zablokowane relacją lub etykietą blocked i informuje o brakujących estimate przed standupem.
CzytamyLiczba Issues w cyklu, liczba Done i otwartych, zgłoszenia bez przypisanego cyklu w workspace'ie
AsystentLiczy stosunek Done do wszystkich Issues i informuje, ile zostało do zamknięcia przed końcem sprintu.
CzytamyStatus projektu, daty kamieni milowych, Issues w projekcie nieprzypisane do żadnego cyklu
AsystentSprawdza, które Milestones mają otwarte Issues po terminie, i podaje liczbę zgłoszeń czekających poza cyklem na roadmapie.
CzytamyZgłoszenia bez przypisanego cyklu z priorytetem Urgent lub High, bez assignee
AsystentWyciąga listę pilnych zgłoszeń pominiętych przy planowaniu sprintu i proponuje ich przejrzenie przed następnym cyklem.
CzytamyStan pull requestów (open, merged, closed) powiązanych z Issues przez integrację GitHub w Linear
AsystentWykrywa Issues w statusie In Review z PR-em bez aktywności od kilku dni i powiadamia przypisaną osobę, zanim opóźnienie wyjdzie na planowaniu.
CzytamyIssues oznaczone etykietą customer-bug, posortowane według priorytetu: Urgent, High, Medium, Low
AsystentZestawia otwarte błędy klientów według priorytetu przed planowaniem cyklu, żeby zespół widział skalę zaległych zgłoszeń przed wciąganiem nowych funkcji.
CzytamyHistoria komentarzy do zgłoszenia, unikalny Identifier (np. ENG-42), data ostatniej aktywności
AsystentDopisuje komentarz z treścią maila klienta do istniejącego Issue przy wykrytym duplikacie i łączy oba relacją duplicate of.
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Co utknęło w bieżącym sprincie i kto jest zablokowany?”
- „Ile zgłoszeń mamy zamkniętych z tego cyklu, a ile zostało?”
- „Jakie błędy klientów są teraz otwarte i które są najpilniejsze?”
- „Które milestones w projektach są po terminie?”
Co się zmienia
Poranny przegląd sprintu zajmuje kilka minut zamiast pół godziny, a błędy od klientów trafiają do Linear automatycznie z wykrytymi duplikatami.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
Linear to narzędzie do zarządzania pracą zespołów produktowych i inżynierskich. Workspace skupia Issues, cykle (Cycles), projekty z kamieniami milowymi i roadmapę produktu. Używają go głównie firmy technologiczne, software house'y i zespoły SaaS, które prowadzą regularne sprinty i śledzą błędy zgłaszane przez klientów.
W codziennej pracy każde zgłoszenie ma kilkanaście pól: status, priorytet, datę graniczną, etykiety, przypisaną osobę, powiązania z innymi Issues i historię komentarzy. Projekty i Milestones dają widok na terminy poza sprintami. Dane trzymane są w chmurze Linear i dostępne przez GraphQL API.
Gdzie to działa najlepiej
Kierownik produktu
Przed porannym standupem menedżer nie otwiera Linear. Asystent wysłał już raport: ile Issues Done w cyklu, które są zablokowane i przez co, które mają przeterminowaną due date i kto je ma.
Z asystentem: Standup trwa krócej, bo odpowiedzi na typowe pytania są gotowe. Blokady i opóźnienia wychodzą na jaw od razu, nie po kilkunastu minutach przeszukiwania tablicy.
Specjalista wsparcia
Po wydaniu nowej wersji aplikacji w ciągu doby przychodzi kilkanaście maili z tym samym błędem przy eksporcie. Bez integracji ktoś zakłada kilkanaście osobnych Issues albo po prostu część ignoruje.
Z asystentem: Asystent zakłada jedno Issue przy pierwszym mailu, do kolejnych dopisuje komentarze i łączy relacją duplicate of. Programista widzi od razu, że problem dotyczy wielu klientów.
Programista
Issue ma status In Review, podpięty pull request stoi od tygodnia bez aktywności i nikt nie zrobił code review. Każdy patrzy tylko na własne zadania i nikt nie pilnuje cudzych PR-ów.
Z asystentem: Asystent wyłapuje PR bez ruchu i dodaje komentarz do Issue lub powiadamia przypisaną osobę. Problem wychodzi przed zakończeniem cyklu, nie po jego zamknięciu.
Jak się łączymy
Łączymy się przez GraphQL API Linear. Jedno zapytanie zwraca naraz Issues z bieżącego cyklu ze wszystkimi polami, bez kilku wywołań po kolei. Do raportów wystarczy zakres read. Do zakładania Issues i pisania komentarzy z maili klientów potrzebny jest zakres write.
Uwierzytelnienie odbywa się przez Personal API key (Settings > API w Linear) lub OAuth 2.0, gdy każda osoba loguje się własnym kontem. Asystent działa na serwerze klienta. Do modelu AI trafia polecenie i fragment danych potrzebny do odpowiedzi, bez trenowania cudzych modeli na danych firmy. Linear obsługuje też webhooks do reagowania na zdarzenia w czasie rzeczywistym.
Czego potrzebujemy od Was
- Konto Linear z dostępem do workspace'u (plan Free wystarczy do odczytu przez API)
- Personal API key z Settings > API > Personal API keys lub aplikacja OAuth 2.0
- Zakres write w kluczu API, gdy asystent ma zakładać Issues i pisać komentarze
- Osoba z firmy znająca etykiety, statusy i strukturę cykli w Waszym workspace'ie
- Połączone repozytorium GitHub w Linear, jeśli chcecie dane o pull requestach przy Issues
Czego asystent nie robi
- Nie zmienia statusów, priorytetów ani przypisań w Linear bez potwierdzenia przez człowieka.
- Nie czyta zawartości załączników binarnych dołączonych do Issues, widzi tylko ich linki.
- Nie zastępuje planowania sprintu: wskazuje blokady i dane, decyzję o wciągnięciu Issues podejmuje zespół.
- Nie ma dostępu do pełnych logów audytu Linear, jeśli API ich nie udostępnia w danym zakresie uprawnień.
Częste pytania
Czy asystent widzi Issues z prywatnych projektów w naszym workspace'ie?
Asystent widzi dokładnie to, co konto, do którego przypisany jest klucz API. Jeśli konto nie ma dostępu do konkretnego projektu lub zespołu w Linear, API też go nie zwróci. Zakres widoczności ustawiacie w Linear, nie w konfiguracji asystenta.
Co jeśli nasz workspace ma tysiące Issues i duże obciążenie API?
GraphQL API Linear ma rate limiting, który przy dużych workspace'ach trzeba uwzględnić. Budujemy zapytania tak, żeby pobierać tylko pola potrzebne do analizy, bez nadmiarowych danych. Zakres zapytań i częstotliwość omawiamy przed uruchomieniem.
Czy możemy zatwierdzać każde zgłoszenie przed zapisem do Linear?
Tak. Asystent może działać w trybie propozycji: przygotowuje Issues z tytułem, opisem i etykietami, a zapis przez API następuje dopiero po Waszym zatwierdzeniu. To przydatne na początku, gdy sprawdzacie, czy etykiety i priorytety są trafione.
Jak często asystent odpytuje Linear: na harmonogramie czy przez webhooks?
Raport poranny działa na harmonogramie, polling raz dziennie ze świeżymi danymi. Webhooks służą do reagowania w czasie rzeczywistym, np. gdy mail klienta ma trafić do Linear w ciągu minut, nie przy kolejnym porannym przeglądzie. Oba tryby można łączyć.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Pokażemy to na Waszych danych z Linear
Jedno zdanie wystarczy: czego szukacie w Linear albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.
Inne programy: komunikacja, projekty i biuro
Linear jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.