Linear

Verbinde Linear, damit Agents aus Untersuchungen Issues anlegen, Status aktualisieren und deinen Issue-Tracker mit dem abgleichen können, was sie finden.

Einrichtung

1. Öffne in Linear Settings und navigiere zu Security & access.
2. Erstelle unter Personal API keys einen Schlüssel. Er braucht Schreibzugriff, damit Agents Issues erstellen und aktualisieren können.
3. Füge den Schlüssel in Polylane ein. Polylane prüft ihn gegen deinen Linear-Workspace und verbindet.

Dein Schlüssel wird vor dem Speichern verschlüsselt, und der Agent sieht ihn nie.

Was Agents tun können

• Teams, Workflow-Zustände, Mitglieder und Projekte auflisten
• Issues auflisten, suchen und mit ihren jüngsten Kommentaren lesen
• Issues aus Untersuchungsergebnissen anlegen, mit der Beweiskette in der Beschreibung
• Zustand, Priorität, Zuständige, Projekt, Labels und Fälligkeitsdatum eines Issues aktualisieren
• Issues mit Ergebnissen und Status kommentieren
• Beliebiges GraphQL gegen die Linear-API ausführen für alles, was oben nicht abgedeckt ist; Mutationen durchlaufen dieselbe Bestätigungsschranke

Schreibzugriffe auf Issues fragen immer nach Bestätigung, bevor sie ausgeführt werden.

Webhooks und Triage

Beim Verbinden wird in deinem Linear-Workspace ein Polylane-Webhook registriert, der Issues in allen öffentlichen Teams abdeckt. Mit dem Webhook:

• Issues, die dringend werden, landen als Alerts und werden triagiert, sobald sie auslösen; wird das Issue herabgestuft oder abgeschlossen, löst sich der Alert auf.

Das Anlegen des Webhooks erfordert, dass der Benutzer des API-Schlüssels in Linear Workspace-Admin ist. Ein Nicht-Admin-Schlüssel verbindet trotzdem, und jedes Agent-Tool funktioniert; nur die webhook-getriebene Triage entfällt.

Fehlerbehebung

Fehler "Invalid API key"

• Verwende einen persönlichen API-Schlüssel aus Security & access; OAuth-Tokens werden nicht unterstützt. Polylane sendet den Schlüssel unverändert im Authorization-Header, ohne Bearer-Präfix, genau wie Linear es für persönliche Schlüssel erwartet.
• Prüfe, ob der Schlüssel in Linear widerrufen wurde.

Keine Alerts oder Trigger aus Linear

• Das Anlegen des Webhooks braucht den Schlüssel eines Workspace-Admins. Verbinde mit dem Schlüssel eines Admins neu, um webhook-getriebene Triage und Trigger zu aktivieren.

Verbindung trennen

Trenne Linear in Polylane, wodurch auch der registrierte Webhook entfernt wird, dann widerrufe den API-Schlüssel in Linear.