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.
Konfiguration
Abschnitt betitelt „Konfiguration“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.
spedy status
Abschnitt betitelt „spedy status“Konfiguration und Erreichbarkeit prüfen. Das ist zugleich der Standard-Unterbefehl: ein
blankes mdocker spedy führt status aus.
mdocker spedy statusmdocker --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).
spedy url
Abschnitt betitelt „spedy url“Die API-URL anzeigen oder setzen. Beim Setzen wird die Eingabe normalisiert und
/api/v1 ergänzt.
mdocker spedy url # aktuelle URL ausgebenmdocker spedy url https://org.spedy.ai # setzenspedy token
Abschnitt betitelt „spedy token“Den Personal Access Token hinterlegen.
mdocker spedy token pat_xxxxxxxxprintf '%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.
spedy boards
Abschnitt betitelt „spedy boards“Listet die Boards, die dein Token sehen darf (prefix, id, name).
mdocker spedy boardsmdocker --json spedy boardsspedy assign / spedy unassign
Abschnitt betitelt „spedy assign / spedy unassign“Bindet ein Projekt an ein Board. assign validiert die ID gegen die Board-Liste.
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.
spedy tickets
Abschnitt betitelt „spedy tickets“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 <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>.
spedy ticket
Abschnitt betitelt „spedy ticket“Vollständige Ticket-Details — immer JSON, mit oder ohne --json.
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.
spedy attachment
Abschnitt betitelt „spedy attachment“Lädt einen Anhang in den Cache unter
$MD_CONFIG_DIR/spedy/cache/<ticketId>/.
mdocker spedy attachment <name> <ticketId> <attId> [<dateiname>]Gibt den lokalen Pfad aus (--json: { "path": "…" }).
spedy open
Abschnitt betitelt „spedy open“Öffnet das Ticket im Browser.
mdocker spedy open <name> <id>spedy session
Abschnitt betitelt „spedy session“Startet eine Claude-Code-Session, die das Ticket als Kontext hat.
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.
Registry-Felder
Abschnitt betitelt „Registry-Felder“".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. |