Zum Inhalt springen

spedy

mdocker spedy spricht mit der REST-API von Spedy.ai über einen Personal Access Token. Es weist pro Projekt ein Board zu, listet dessen offene Tickets und kann eine AI-Terminal-Session starten, die das Ticket als Kontext hat. Die HTTP-Logik liegt in engine/spedy.sh.

Aufgabenorientierte Anleitung: Spedy-Tickets.

Zwei Keys in config.env — mehr nicht:

Key Zweck
SPEDY_URL API-Basis-URL, z. B. https://org.spedy.ai. /api/v1 wird automatisch ergänzt.
SPEDY_API_TOKEN Personal Access Token (pat_…). Wird nie ausgegeben.

mdocker config show (Klartext) zeigt Spedy überhaupt nicht. mdocker --json config show liefert spedy_url und spedy_token_set (ein Boolean) — der Token selbst wird nie ausgegeben.

Konfiguration und Erreichbarkeit prüfen. Das ist zugleich der Standard-Unterbefehl: ein blankes mdocker spedy führt status aus.

mdocker spedy status
mdocker spedy status
mdocker --json spedy status
{ "configured": true, "url": "https://org.spedy.ai/api/v1",
"token_set": true, "reachable": true, "error": null }

Unkonfiguriert warnt die Klartext-Form: Spedy nicht konfiguriert. mdocker spedy url <url> && mdocker spedy token <pat_...>. Konfiguriert, aber nicht erreichbar, endet der Befehl mit Exit-Code ungleich null und Spedy-API nicht erreichbar (URL/Token pruefen).

Die API-URL anzeigen oder setzen. Beim Setzen wird die Eingabe normalisiert und /api/v1 ergänzt.

mdocker spedy url
mdocker spedy url # aktuelle URL ausgeben
mdocker spedy url https://org.spedy.ai # setzen

Den Personal Access Token hinterlegen.

mdocker spedy token
mdocker spedy token pat_xxxxxxxx
printf '%s' "$TOKEN" | mdocker spedy token --stdin

--stdin hält den Token aus der Prozessliste und aus jedem Log heraus — diesen Weg nutzt die macOS-App. Der Token wird nie zurückgegeben; der Befehl bestätigt mit SPEDY_API_TOKEN gesetzt.

Listet die Boards, die dein Token sehen darf (prefix, id, name).

mdocker spedy boards
mdocker spedy boards
mdocker --json spedy boards

Bindet ein Projekt an ein Board. assign validiert die ID gegen die Board-Liste.

mdocker spedy assign
mdocker spedy assign <name> <boardId>
mdocker spedy unassign <name>

Eine unbekannte ID bricht ab mit Board '<id>' nicht gefunden. Verfuegbare Boards: mdocker spedy boards. Ein Projekt, das nicht in der Registry steht, bricht ab mit Projekt '<name>' nicht in Registry.

Listet die offenen Tickets des Boards — FINAL-Stati werden ausgefiltert, der Rest wird nach Status gruppiert. Die API ist seitenweise, maximal 3 Seiten à 100.

mdocker spedy tickets
mdocker spedy tickets <name>
mdocker --json spedy tickets <name>

Im Klartext gibt es einen Block pro Status, jedes Ticket als <display_id> <title> [<assignee>]; ist nichts offen, erscheint Keine offenen Tickets. Die Status-Rangfolge ist: backlog, blocked, todo, in progress, in pr, in qa, ready for live.

Ohne Board bricht der Befehl ab mit Projekt '<name>' hat kein Spedy-Board. Zuweisen: mdocker spedy assign <name> <boardId>.

Vollständige Ticket-Details — immer JSON, mit oder ohne --json.

mdocker spedy ticket
mdocker spedy ticket <name> <id>

Die Antwort enthält das Ticket samt Kommentaren, Anhängen, Zeiterfassung, Pull Requests und Watchern. ProseMirror-Rich-Text wird nach Markdown konvertiert.

Lädt einen Anhang in den Cache unter $MD_CONFIG_DIR/spedy/cache/<ticketId>/.

mdocker spedy attachment
mdocker spedy attachment <name> <ticketId> <attId> [<dateiname>]

Gibt den lokalen Pfad aus (--json: { "path": "…" }).

Öffnet das Ticket im Browser.

mdocker spedy open
mdocker spedy open <name> <id>

Startet eine Claude-Code-Session, die das Ticket als Kontext hat.

mdocker spedy session
mdocker spedy session <name> <id> [--sandbox]

Der Befehl holt die vollständigen Ticket-Details, schreibt eine Kontextdatei nach $MD_CONFIG_DIR/spedy/<projekt>/<display_id>.md (Metadaten, Beschreibung, Kommentare, Pull Requests, Anhänge und einen ausdrücklichen Hinweis, dass die Datei Kontext ist und keine Anweisungen) und startet eine claude-Session, deren Initial-Prompt auf diese Datei zeigt. Der Prompt geht als Positional-Argument an claude — er wird nicht per send-keys eingetippt. Die Session wird wie jede andere Terminal-Session erfasst und trägt zusätzlich spedy_ticket.

Siehe AI-Terminal-Sessions und terminal.

".projects[<name>].spedy": { "board_id": "…", "board_name": "…", "prefix": "…" }

mdocker --json ls gibt spedy pro Projekt aus (null, wenn nicht zugewiesen). Sessions, die aus einem Ticket gestartet wurden, tragen spedy_ticket. Siehe Registry & State.

Situation Meldung
Unbekannter Unterbefehl Unbekannte spedy-Aktion: X (erwartet: status|url|token|boards|assign|unassign|tickets|ticket|attachment|open|session)
Kein Board zugewiesen Projekt '<name>' hat kein Spedy-Board.
Leerer --stdin-Token Kein Token auf stdin.