Zurück zum Blog
X24LABS

Erste Schritte mit Stitch 2.0

Eine praktische Anleitung zu Stitch 2.0: installieren, ausführen, beobachten. Keine Konfigurationsdateien, keine API-Keys, keine neuen Pipeline-Jobs. Nur dein bestehendes CI, lokal ausgeführt, mit einem KI-Agenten auf Abruf.

Stitch 2.0 ist eine local-first CLI. Sie liest die CI-Konfiguration, die schon in deinem Repository liegt, führt dieselben Jobs auf deiner Maschine aus und übergibt jeden Fehler an einen KI-Agenten (Claude Code oder Codex), der ihn behebt. Dieser Beitrag ist die Fünf-Minuten-Version der Dokumentation.

Voraussetzungen

Das ist die gesamte Abhängigkeitsliste. Stitch braucht keinen API-Key, kein Docker-Image und kein Plattform-Token. Es läuft als du, auf deiner Maschine, mit dem Agenten, der schon angemeldet ist.

Installieren und ausführen

Es gibt keinen Installationsschritt. Das Paket ist auf npm veröffentlicht. Führe es direkt aus:

npx stitch-agent run claude

Oder, wenn du Codex bevorzugst:

npx stitch-agent run codex

Beim ersten Lauf erkennt Stitch, welche CI-Konfiguration du hast, parst sie und zeigt dir die Jobs, die es ausführen wird. Infrastruktur-Jobs (Deploy, Publish, Release, Image-Pushes) werden automatisch ausgefiltert. Verify-Jobs (Lint, Typecheck, Test, Build) sind die, die lokal laufen.

Das Terminal wechselt in eine interaktive TUI. Du siehst:

Du kannst zusehen oder weggehen. Stitch stoppt bei der ersten grünen Gesamtpipeline, am Versuchs-Limit (Standard drei Versuche pro Job) oder bei der ersten Sache, die es an dich eskalieren will.

Was passiert, wenn ein Job fehlschlägt

Stitch übergibt den fehlschlagenden Job an deinen Agenten mit einem kurzen Prompt und dem relevanten Kontext. Der Agent macht sein Ding: er liest die Dateien im Fehler, versucht einen Fix und sagt Stitch, den Job neu auszuführen. Stitch validiert, indem es denselben Job tatsächlich neu ausführt. Wenn der Re-Run besteht, zählt der Versuch als Fix. Wenn er fehlschlägt, versucht der Agent es erneut, bis zum Limit pro Job.

Die Schleife ist bewusst begrenzt. Wenn drei Versuche keinen Fix landen, stoppt Stitch und zeigt dir den Zustand: die letzte Diagnose, den letzten Patch, das letzte Log. Du übernimmst mit vollem Kontext.

Commit und Push

Wenn ein Fix-Zyklus mit jedem Job grün endet, kann Stitch das Ergebnis committen und pushen. Das passiert nur, wenn zwei Bedingungen wahr sind:

  1. Du warst auf einem sauberen Branch, als Stitch startete. Wenn es uncommitete Änderungen gab, lässt Stitch den Working Tree in Ruhe. Deine laufende Arbeit wird nie angefasst.
  2. Du hast Auto-Commit angefordert. Standardmäßig aus. Das Flag ist --auto-commit.

Das ist bewusst konservativ. Der schnellste Weg, Vertrauen in ein Tool wie Stitch zu verlieren, ist, wenn es deine lokale Arbeit überschreibt. Wir möchten lieber, dass du zustimmst, als dass du dich fragst, was passiert ist.

Watch-Modus

Für enge Iterationsschleifen kann Stitch weiterlaufen und bei Dateiänderungen neu verifizieren:

npx stitch-agent run claude --watch

Im Watch-Modus triggert das Speichern einer Datei einen Re-Run der betroffenen Jobs. Du bearbeitest, du speicherst, du siehst Grün oder Rot in der TUI in Sekunden, ohne deinen Editor zu verlassen. Das ersetzt die Gewohnheit “pushen, um zu sehen, ob CI zufrieden ist” durch “speichern und sehen”.

Konfiguration, falls gewünscht

Null Konfiguration ist der Standard und bewältigt die meisten Repositories. Wenn du das Verhalten anpassen willst, lege eine .stitch.yml in die Repo-Wurzel:

max_attempts: 3
auto_fix: [lint, format, simple_types, config_ci]
escalate: [logic_errors, breaking_changes, dependency_conflicts]

Du brauchst diese Datei nicht, um Stitch zu nutzen. Sie existiert für Teams, die explizite Policy wollen.

Was Stitch nicht ist

Stitch ersetzt dein CI nicht. Die Remote-Pipeline läuft weiterhin beim Push. Stitch gibt dir nur eine schnellere, lokale, KI-assistierte Version derselben Sache, damit du mit Zuversicht statt Hoffnung zum Push kommst.

Stitch trainiert nicht auf deinem Code. Es ruft nicht nach Hause. Es gibt keine Telemetrie zum Abschalten, weil nichts irgendwohin berichtet. Logs und Fixes bleiben lokal, außer du konfigurierst explizit einen Benachrichtigungskanal.

Stitch braucht kein eigenes Abo. Der einzige bezahlte Dienst in der Schleife ist der Agent (Claude Code oder Codex), und der wird über den Account abgerechnet, den du schon hast.

Wohin als Nächstes

Das Repository liegt auf GitHub unter x24labs/stitch. Issues werden dort verfolgt. Das npm-Paket ist stitch-agent. Der Rest steht im Code und in den vorherigen Beiträgen dieser Serie, die erklären, warum v2 so aussieht, wie es aussieht.

Wenn du es probierst und etwas bricht, öffne ein Issue. Der Punkt bei local-first ist, dass du alles vor dir hast, was du brauchst, um das Problem zu reproduzieren.

Zurück zum Blog