Linear

In Linear wird ein Großteil der eigentlichen Engineering-Arbeit erfasst -- Bugs, Feature-Wünsche, Projekte --, und durch das Verbinden kann tAI diese Erfassung direkt aus einer Unterhaltung heraus durchsuchen, lesen und erstellen, statt dass du dafür die Tabs wechselst und es von Hand erledigst.

Er wird genau wie jeder Connector über Settings -> Connectors verbunden, über Linears eigenen OAuth-Autorisierungsbildschirm, auf dem du genehmigst, in welchem Workspace tAI handeln darf. tAI bekommt dein Linear-Passwort nie zu sehen, nur das Zugriffstoken, das Linear nach deiner Genehmigung ausstellt.

Sobald verbunden, werden zehn Tools verfügbar -- sie decken Suche, das vollständige Lesen von Issue-Details, das Erstellen von Issues und Projekten, das Auflisten von Teams und Projekten, das Aktualisieren des Status eines Issues, dessen Zuweisung an jemanden, das Kommentieren sowie das Anhängen einer Datei aus der Sandbox ab.

linear_search_issues durchsucht deinen verbundenen Workspace nach Titel und liefert die passenden Issues zurück, ähnlich wie eine Eingabe in Linears eigener Suche. Es ist der Ausgangspunkt für nahezu jede Anfrage, die sich auf bestehende Arbeit bezieht, statt um die Erstellung von etwas völlig Neuem zu bitten.

linear_read_issue nimmt ein über die Suche gefundenes Issue entgegen und liefert dessen vollständige Details zurück -- Status, Beschreibung und alles Weitere, was tatsächlich in diesem Issue steht -- statt nur des Titels, den ein Suchergebnis zeigen würde. tAI nutzt es immer dann, wenn eine Anfrage den eigentlichen Inhalt eines Issues benötigt, nicht nur die Bestätigung, dass es existiert.

linear_create_issue erstellt ein neues Issue im Workspace. Hat der Workspace mehr als ein Team, muss das Tool wissen, zu welchem Team das Issue gehört -- tAI nutzt dafür Kontext aus der Unterhaltung, wenn er eindeutig ist, oder fragt direkt nach, wenn nicht, statt zu raten und etwas am falschen Ort abzulegen.

linear_create_project funktioniert genauso, nur für Projekte statt Issues: Es erstellt ein neues Projekt, und hat der Workspace mehrere Teams, muss aus demselben Grund ein Team angegeben werden -- Linear selbst verlangt, dass ein Projekt zu einem Team gehört, und tAI arbeitet innerhalb dieser Vorgabe, statt sie zu umgehen.

Diese Team-Vorgabe sollte man als echte strukturelle Einschränkung von Linear verstehen, nicht als eine Einschränkung, die tAI hinzufügt -- ein Workspace mit nur einem Team löst die Nachfrage nie aus, da es ohnehin nur einen Ort gibt, an dem ein neues Issue oder Projekt landen könnte.

Eine realistische Anfrage zum Suchen und Zusammenfassen lautet etwa 'finde offene Issues, die Export erwähnen, und fasse deren Status zusammen' -- tAI sucht und liest anschließend die wirklich relevant erscheinenden Issues, um deren tatsächlichen Status zu ermitteln, statt nur die Titel zu melden, die die Suche zurückgeliefert hat.

Eine realistische Erstellungs-Anfrage lautet etwa 'erstelle ein Issue mit dem Titel CSV-Export läuft in ein Timeout unter dem Engineering-Team' -- das Team ist von vornherein angegeben, sodass linear_create_issue sofort ausgeführt werden kann, ohne zuerst nachfragen zu müssen.

Suchen und Lesen werden häufig auch innerhalb einer einzigen Anfrage verkettet: Die Frage 'wie ist der Status des Login-Redirect-Bugs' erfordert zunächst das Finden über den Titel und dann das Lesen des tatsächlichen aktuellen Status -- beide Schritte erfolgen innerhalb derselben Antwort.

tAI entscheidet anhand deiner Anfrage, welches dieser vier Tools zum Einsatz kommt, genau wie bei jedem anderen Connector -- eine Frage, die nichts mit erfasster Arbeit zu tun hat, ruft keines davon auf, und eine Anfrage, die nur um das Finden von etwas bittet, berührt niemals die beiden Erstellungs-Tools.

Da linear_search_issues auf den Titel abgleicht, liefert eine sehr vage Beschreibung, die keine der tatsächlichen Formulierungen des Issues enthält, unter Umständen nicht das richtige Ergebnis -- die Erwähnung eines Stichworts, das wahrscheinlich im Titel steht, etwa 'Export' oder 'Login', liefert deutlich bessere Ergebnisse als eine rein konzeptionelle Beschreibung.

Das Verbinden von Linear ist bei tAI eine Aktion auf Kontoebene: einmal über Settings verbunden, hat jede neue Unterhaltung von da an Zugriff darauf -- ein erneutes Verbinden pro Chat ist nicht nötig.

Das Trennen erfolgt über denselben Connectors-Tab und betrifft nur den zukünftigen Zugriff -- Issues oder Projekte, die linear_create_issue oder linear_create_project bereits erstellt haben, bleiben genau dort, wo sie in Linear sind, denn einmal erstellt sind es ganz normale Linear-Objekte, die nicht weiter von der aktiven Verbindung verwaltet werden.

Welche Teams und Issues tAI tatsächlich erreichen kann, hängt davon ab, worauf das verbundene Linear-Konto selbst Zugriff hat -- der Connector gewährt keine Berechtigung, die über das hinausgeht, was die Person, die die Autorisierung genehmigt hat, im Workspace bereits besaß.

Linear in einer Anfrage mit GitHub zu kombinieren, ist bei Engineering-Arbeit gängig: Bei 'finde den CSV-Export-Bug in Linear, behebe ihn und eröffne einen Pull Request mit Bezug auf das Issue' liest tAI zunächst das Issue für den Kontext, bevor überhaupt Code angefasst wird, damit die Korrektur wirklich das behebt, was im Issue beschrieben ist.

Es lohnt sich, klar zu benennen, was dieser Connector nicht kann: Er kann den Status eines bestehenden Issues nicht aktualisieren, Issues nicht Personen zuweisen, keine Issues oder Projekte löschen und keine Kommentare zu einem Issue verfassen. Sein Schreibzugriff beschränkt sich auf das Erstellen neuer Issues und neuer Projekte.

Ebenso gibt es keine Möglichkeit, die vollständige Issue-Liste eines Teams unabhängig von einem Suchbegriff zu durchstöbern -- linear_search_issues braucht etwas, womit es abgleichen kann. Eine Anfrage wie 'zeig mir alles in Linear' ist daher nichts, was dieser Connector direkt beantwortet; er funktioniert am besten, wenn er auf etwas Konkretes gerichtet wird -- ein Stichwort, ein Thema, einen ungefähren Titel.

Es findet keinerlei Einrichtung außerhalb der tAI-App und Linears eigenem OAuth-Bildschirm statt -- kein API-Key, der von Hand generiert werden müsste, nichts, was in Linear selbst konfiguriert werden müsste, abgesehen von der einmaligen Genehmigung der Autorisierungsanfrage.

Vollständige Details dazu, was tAI mit dem Workspace-Zugriff tut und nicht tut, findest du in der Linear-Datenschutzrichtlinie, die am Ende dieser Seite verlinkt ist, im selben Settings -> Connectors-Bereich, über den auch die Verbindung verwaltet wird.