SpedySpedy Docs

IDE- & Browser-Extensions

Bring Spedy in deinen Editor und Browser — mit dem JetBrains-Plugin und der Chrome-Extension.

Spedy bietet Extensions für JetBrains-IDEs und Google Chrome, damit du mit Tickets und Boards arbeiten kannst, ohne dein Werkzeug zu verlassen.

JetBrains-Plugin

Das Spedy-Plugin für JetBrains-IDEs bringt dein Ticket-System direkt in den Editor. Tickets durchsuchen, neue anlegen, Kommentare schreiben, zwischen Code-Referenzen und Tickets springen, KI-Coding-Agents mit vollem Ticket-Kontext starten und Arbeit an Runner-Teams übergeben — alles ohne den Browser zu öffnen.

Installiere es aus dem JetBrains Marketplace.

Unterstützte IDEs

IntelliJ IDEA, WebStorm, PyCharm, GoLand, PhpStorm, RubyMine, CLion, Rider und Android Studio. Voraussetzung: Version 2025.2 oder neuer (Java 21+ ist in allen aktuellen JetBrains-IDEs enthalten).

Installation

  1. Öffne Settings → Plugins → Marketplace in deiner JetBrains-IDE
  2. Suche nach Spedy
  3. Klicke Install und starte die IDE neu
  4. Öffne das neue Spedy-Tool-Window in der Seitenleiste
  5. Klicke Connect — dein Browser öffnet sich und du authentifizierst dich per OAuth mit deiner Spedy-Organisation

Funktionen

Ticket-Tool-Window

Ein eigenes Tool-Window in der Seitenleiste zeigt deine Tickets. Du kannst:

  • Nach Board, Status, Bearbeiter:in oder Suchbegriff filtern
  • Jedes Ticket öffnen und die vollständigen Details sehen (Beschreibung, Status, Priorität, Bearbeiter:in, Kommentare)
  • Neue Tickets direkt aus der IDE anlegen — mit Markdown-Support
  • Per Rechtsklick auf eine Ticket-Zeile Schnellaktionen ausführen: Assign team…, Launch in deinem KI-Agent, Copy ID + title + description oder Copy ticket ID

Live-Ticket-Referenzen

Das Plugin erkennt Ticket-IDs (wie ACME-42 sowie mehrteilige IDs wie AH-1-157) in deinem Code, Kommentaren, Commit-Messages und jeder anderen Datei, die die IDE darstellen kann. Erkannte IDs werden hervorgehoben und verlinkt:

  • Hover über eine Ticket-ID zeigt ein Docpop mit Status (farbcodierter Chip), Titel, Bearbeiter:in, Priorität und Fälligkeitsdatum
  • Klick auf die ID öffnet das vollständige Ticket im Spedy-Tool-Window

Ein begrenzter TTL-Cache hält die Hover-Daten auch in Dateien mit hunderten Referenzen schnell, aktualisiert im Hintergrund und greift offline auf die gecachten Daten zurück.

IntelliJ-Tasks-Integration

Das Plugin registriert sich als Task-Repository für IntelliJs eingebautes Tasks-System. Nach dem Login wird das aktive Projekt automatisch verdrahtet. Das ermöglicht:

  • Branch-BenennungOpen as Task auf einem Ticket schlägt einen Branch-Namen aus Ticket-ID und Titel vor (z. B. AG-410/ai-launcher-from-ticket)
  • Status-Sync — das Abschließen einer Task kann das Spedy-Ticket in den „Done"-Status deines Teams überführen
  • VCS-Integration — die Issue-Navigation in Commits und VCS-Tools öffnet die Ticket-Details direkt in deiner IDE

Kommentare und Statuswechsel

Schreibe Ticket-Kommentare in einem eigenen Editor-Tab innerhalb der IDE:

  • Vollständiges Markdown-Rendering
  • @-Mention-Autocomplete für Teammitglieder
  • Ticket-Status direkt aus dem Kommentar-Editor ändern

KI-Coding-Agents aus einem Ticket starten

Öffne ein Ticket und klicke Launch in Claude Code (oder wähle per Rechtsklick auf eine Zeile denselben Eintrag). Das Plugin bündelt alles, was der Agent zum Loslegen braucht:

  1. Holt die Ticket-Details, alle Kommentare und alle Anhänge
  2. Lädt Anhänge nach .spedy/attachments/<ticket-id>/, damit der Agent sie über absolute Pfade lesen kann
  3. Erstellt einen Markdown-Prompt unter .spedy/prompts/<ticket-id>.md mit Titel, Status, Bearbeiter:in, vollständiger Beschreibung, allen Kommentaren (mit Autor:in + Zeitstempel) und der Liste der Anhänge
  4. Öffnet einen neuen Terminal-Tab in der IDE und startet den Agent mit dem Prompt als erster Nachricht

Der Agent weiß jetzt, worum es im Ticket geht — kein Copy-Paste, kein Kontextwechsel. Deinen Standard-Agent wählst du unter Settings → Spedy → AI launcher:

  • Claude Code — der empfohlene Weg; unterstützt projektbezogenes MCP und Claudes Permission-Modi
  • Codex CLI — derselbe Prompt gegen die OpenAI Codex CLI
  • Junie — bei installiertem JetBrains-AI-Plugin wird der Prompt in die Zwischenablage kopiert und der Junie-Chat in den Fokus geholt

Die CLI-Befehle sind konfigurierbar, sodass ein eigener Binary-Pfad oder ein Wrapper-Skript sauber eingebunden werden kann. Du kannst außerdem festlegen, ob Kommentare und Anhänge mitgegeben werden.

MCP-Setup ohne Konfiguration

Aktiviere Auto-create .mcp.json on first launch in den AI-Launcher-Einstellungen und füge eine .mcp.json-Vorlage ein. Beim ersten Start eines Agents in einem Projekt schreibt das Plugin eine projektbezogene .mcp.json aus dieser Vorlage (vor dem Schreiben validiert) — so können Claude Code und jeder andere MCP-fähige Client ohne manuelle Einrichtung Spedy-Tickets lesen und aktualisieren.

Vorhandene .mcp.json-Dateien werden nie überschrieben, und der Schalter steht standardmäßig auf aus, damit nichts ohne ausdrückliche Zustimmung in dein Projekt geschrieben wird.

KI-Runner-Teams zuweisen

Rechtsklicke auf ein Ticket und wähle Assign team…, um es an ein konfiguriertes KI-Runner-Team zu übergeben — eine Pipeline aus Agents (Planning, Coding, Review, Respond), die den Job aufnimmt, während der Arbeit am Ticket kommentiert und es automatisch durch die Working-/Completion-/Failure-Status deines Teams bewegt.

Öffne den Runner-Tab im selben Tool-Window, um live per SSE gestreamte Events zu verfolgen — Tool-Aufrufe, Modell-Ausgaben, Statuswechsel — sowie die aggregierten Kosten pro Job, ohne die IDE zu verlassen.

Offline-Code-Review mit .spsx

Für Reviews, die für einen Pull Request zu klein sind, bringt das Plugin das .spsx-Selection-Package-Format mit. Markiere einen Bereich in einem beliebigen Editor, wähle Spedy → Export selection as .spsx, und du erhältst eine einzelne, in sich geschlossene Datei mit dem ausgewählten Code (samt Kontext), Dateipfad und Commit/Branch, der Sprache für das Syntax-Highlighting und einem Annotations-Thread.

Empfänger:innen öffnen die .spsx wie jede andere Datei: Das Plugin rendert den annotierten Ausschnitt mit dem Original-Highlighting, zeigt den Kommentar-Thread inline und erlaubt Antworten — alles offline, ohne Server-Round-Trip oder Spedy-Konto. Zurückspeichern, weitersenden, bis der Thread geklärt ist.

Authentifizierung

Das Plugin nutzt OAuth 2.0 mit PKCE — der Industriestandard für Desktop-Anwendungen. Dein Access-Token wird im eingebauten Credential-Store der IDE gespeichert, nicht in Klartext-Konfigurationsdateien.

Zum Trennen öffnest du die Plugin-Einstellungen und klickst Disconnect.


Chrome-Extension

Die Spedy Chrome-Extension bringt Ticket-Kontext in deinen Browser-Workflow.

Installiere sie aus dem Chrome Web Store.

Was sie kann

  • Schneller Zugriff auf deine zugewiesenen Tickets über die Browser-Toolbar
  • Tickets von jeder Webseite aus erstellen
  • Ticket-Details in einem Popup sehen, ohne die aktuelle Seite zu verlassen

Einrichtung

  1. Installiere die Extension aus dem Chrome Web Store
  2. Klicke auf das Spedy-Icon in der Toolbar
  3. Melde dich mit deinem Spedy-Konto an