SpecWeave CLI 3.1.0Kostenlos und Open Source
Die Arbeit überdauert die Sitzung.
Dein Agent schreibt den Code. SpecWeave hält fest, was „fertig“ heißt, was es belegt und wo du aufgehört hast, als einfache Dateien in Git, damit Claude Code, Codex oder jeder andere Agent dieselbe Aufgabe fortsetzen kann.
npm i -g specweaveVersion 3.1.0, veröffentlicht am 17 October 2026. Kostenlos und Open Source.
$ specweave pickup Picked up the handoff from claude@cloud (out of tokens): applied 7 uncommitted files. SpecWeave pickup · you are codex@laptop Increment 0001-resumable-checkout "Resumable checkout" (active) · tasks 1/2 done Next: T-02 Restore the draft on return AC-01: Returning within 24 hours restores the cart and shipping choice AC-02: A paid order is never restored Files: src/restore.js | Test: npm test Branch: main · in sync with origin/main · 3 uncommitted files Last handoff: claude@cloud: out of tokens · next: finish restore on return Notes: - claude@cloud: Payment thread: drafts must never store card data
Sechs Befehle vom Plan bis zum Abschluss
Jeder Schritt hinterlässt eine Datei. Nichts schließt auf ein Häkchen hin: Der Test läuft, seine Ausgabe wird gespeichert, und das Increment bleibt offen, bis die Verifizierung besteht.
01 Das Increment planen
$ specweave create-increment "Resumable checkout"Der Agent füllt Problem, Scope, nummerierte Akzeptanzkriterien, Approach und Tasks aus. Bevor er schreibt, fragt sw-increment nur die Entscheidungen ab, die dich brauchen, eine nach der anderen mit einer empfohlenen Antwort: standardmäßig höchstens fünf, und
planning.deepInterviewlegt die Tiefe fest.spec.mdJede Aufgabe nennt ihre Kriterien, ihre Dateien und ihren Test.02 Eine Aufgabe übernehmen
$ specweave task claim T-02Die Übernahme landet im Ledger, sodass ein zweiter Agent, der dieselbe Aufgabe anfragt, abgewiesen wird. Eine Übernahme, die älter als zwei Stunden ist, gilt als veraltet und kann übernommen werden.
specweave task nextgibt die nächste Aufgabe mit dem Text ihrer Kriterien aus.ledger.jsonlNur anhängen: claim-, done-, release-, skip- und block-Ereignisse.03 Beweisen, dass es fertig ist
$ specweave task done T-02 --run "npm test"Die CLI führt den Test selbst aus. Nur Exit 0 verbucht die Aufgabe als erledigt, mit dem Commit und dem Ende der Ausgabe als Nachweis. Ein fehlgeschlagener Lauf verbucht nichts.
reports/task-T-02.txtDie vollständige Befehlsausgabe, mit Exit-Code und Zeit.04 Das Increment verifizieren
$ specweave verifyFührt deine Test-, Lint- und Build-Befehle aus, aus
testing.commandsoder erkannt auspackage.json, Cargo, pytest oder Go, und prüft jedes Akzeptanzkriterium.reports/verify.jsonok ist nur dann true, wenn jeder Befehl und jedes Kriterium besteht.05 Review durch das andere Modell
$ specweave reviewÜbergibt den Diff an einen Reviewer aus einer anderen Modellfamilie als der, die ihn geschrieben hat: Codex prüft Claudes Code, Claude prüft den von OpenAI. Exit 0 heißt ausliefern, Exit 3 heißt erst beheben.
--briefgibt das Briefing zum Einfügen in jedes Tool aus. Neu in 3.1.0; siehe Review mit einem anderen Modell.reports/review-codex.mdDie Befunde und das Urteil, benannt nach dem Reviewer.06 Abschließen
$ specweave complete 0001Verweigert den Abschluss, solange
reports/verify.jsonfehlt oder nicht ok ist. Ohne sie zu schließen erfordert--reason, und der Grund wird beim Increment gespeichert.metadata.jsonAbgeschlossen, oder der Grund, warum ohne Nachweis geschlossen wurde.
Befehle, Flags und Dateinamen wie in specweave 3.1.0. Increment, Aufgabe und Reviewer sind das Beispiel, das auf dieser Seite durchgängig verwendet wird.
Keine Tokens mehr ist nicht das Ende
Sag „hand off“ in dem Tool, das du verlässt, und „pick up where I left off“ im nächsten. Codex kann fortsetzen, was Claude Code begonnen hat, auf demselben Rechner oder einem anderen. Nichts wird zwischen Tools kopiert: specweave handoff pusht einen Snapshot nach specweave-handoff und wip/<branch> und fügt ein Ledger-Ereignis hinzu.
handoff --allSchreibt einen Index aller aktiven Increments und aller verschachtelten Repositories mit rein lokaler Arbeit.pickup --listZeigt die ausstehenden Übergaben, neueste zuerst, und ändert nichts.pickup <ID oder Titel>Wählt eine bestimmte aus, wenn mehrere warten.handoff --no-pushBehält die Übergabe auf diesem Rechner, statt sie auf dein Remote zu pushen.
Abgebend: Claude Code, als claude@cloud
$ specweave handoff --reason "out of tokens"
Handed off 0001-resumable-checkout (released T-02, pushed your uncommitted edits).
To continue in any tool, machine or account, say "pick up" there (or run `specweave pickup`).
Details: .specweave/increments/0001-resumable-checkout/handoff.mdEin Snapshot, auf dein Remote nach specweave-handoff und wip/<branch> gepusht, plus ein Übergabe-Ereignis im Ledger
Übernehmend: Codex, als codex@laptop
$ specweave pickup Picked up the handoff from claude@cloud (out of tokens): applied 7 uncommitted files. SpecWeave pickup · you are codex@laptop Increment 0001-resumable-checkout "Resumable checkout" (active) · tasks 1/2 done Next: T-02 Restore the draft on return
Die Pickup-Zeilen sind echte Ausgabe aus einem zweiten Klon, der als Codex läuft. Die Handoff-Zeilen sind die exakte Meldung der CLI für denselben Lauf.
Nutzungslimits, abgefangen bevor sie greifen
specweave auto-handoff on fügt Claude Code, Codex und Grok Build Hooks hinzu. Jeder Hook speichert einen lokalen Checkpoint, und bei 95 % eines beliebigen Nutzungsfensters entscheidet der Modus, was passiert (Grok meldet keinen Prozentwert, daher greift sein Hook, wenn ein Zug sein Ratenlimit erreicht).
suggestStandard- An der Schwelle
- Sagt dir einmal, dass eine Übergabe bereit ist, und arbeitet weiter.
- Geeignet für
- Der Standard. Du entscheidest, wann gewechselt wird.
enforce- An der Schwelle
- Führt specweave handoff aus und beendet die Sitzung.
- Geeignet für
- Unbeaufsichtigte Läufe, die an einer Aufgabengrenze sauber stoppen sollen.
checkpoint- An der Schwelle
- Speichert nur lokale Checkpoints und übergibt nie.
- Geeignet für
- Tarife, bei denen Guthaben oder ein Proxy über das Limit hinaus weiterarbeiten.
--at 90Verschiebt die Schwelle; der Standard ist 95.--wait-under 30Tut nichts, wenn jedes volle Fenster innerhalb dieser Anzahl Minuten zurückgesetzt wird; der Standard ist 30.autocompact onKomprimiert Claude Code bei 400K Tokens statt nahe einer Million, damit späte Züge klein bleiben.
Agenten in SpecWithCode ausführen? Nutze einen Rechner pro Anbieter-Abo: Lass jeden Rechner dauerhaft bei jedem Anbieter mit einem Konto angemeldet und füge einen Rechner hinzu, wenn du mehr Kapazität brauchst, statt Abos von Hand zu wechseln.
Sieben Skills von Haus aus, vier bei Bedarf
Skills sind kurze Anweisungen, die dein Agent bei Bedarf lädt. Seit 3.1.0 schalten sich die optionalen ein, wenn dein Projekt sie braucht. specweave skills list zeigt, warum jeder aktiv ist, und mit enable oder disable änderst du es.
In jedem Projekt
sw-increment- Plant das Increment als eine spec.md und fragt zuerst die kritischen Entscheidungen ab.
sw-grill-me- Befragt dich in Runden, bis jede Entscheidung in einem Plan geklärt ist. Ist planning.deepInterview auf deep gesetzt, läuft er bei jedem neuen Increment.
sw-do- Arbeitet das Increment Aufgabe für Aufgabe ab: übernehmen, in den zugehörigen Dateien umsetzen, testen, committen, mit Nachweis abhaken. Allein, unbeaufsichtigt oder in parallelen Bahnen.
sw-auto- Führt ein Increment unbeaufsichtigt aus, bis jede Aufgabe erledigt ist, verifiziert und schließt es dann.
sw-review- Ein kritisches Review durch einen frischen Kontext oder eine andere Modellfamilie. Jeder Befund nennt Datei und Zeile.
sw-done- Schließt das Increment: Aufgaben erledigt, Verify grün, Review mit frischem Kontext, dann complete.
sw-handoff- Übergibt die Arbeit an ein anderes Tool, Konto oder einen anderen Rechner und nimmt sie dort wieder auf.
Wenn das Projekt sie braucht
sw-glossary- Baut
GLOSSARY.md, die gemeinsamen Begriffe des Projekts.specweave glossary check --strictlässt die CI bei Abweichungen fehlschlagen. sw-sync- Überträgt Increments nach GitHub, Jira oder Azure DevOps. Aktiv, wenn das Projekt einen Tracker hat.
sw-project- Liest und aktualisiert den Projekt-Hub. Aktiv, wenn
.specweave/project/hub.jsonexistiert. sw-jev- Übergibt Entscheidungen aus einer festen Auswahl an Jev. Aktiv, wenn
jev.enabledgesetzt ist.
Eine Aufzeichnung, die du prüfen kannst
Alles oben sind gewöhnliche Dateien in deinem Repository. Git-Review und Zugriffskontrollen schützen die Historie; diese Dateien sind kein manipulationssicheres Audit-System.
spec.mdWas „fertig“ heißt
Bei der Planung geschrieben und vor dem Code gelesen.
ledger.jsonlWas passiert ist
Übernahmen, Abschlüsse mit Nachweis, Notizen und Übergaben.
reports/Was es belegt hat
Aufgabenprotokolle,
verify.md,verify.jsonund Review-Berichte.handoff.mdWo du aufgehört hast
Geschrieben von
specweave handoff.specweave noteNotizen für den nächsten Agenten
Im Ledger gespeichert, und
pickupzeigt sie an..specweave/memory/Entscheidungen, die die Sitzung überdauern
Eine Datei pro Fakt, in
MEMORY.mdindiziert und committet, sodass jedes Tool und jedes Konto sie sieht.specweave dashboardEin Board für alles
Nur lokal, standardmäßig auf 127.0.0.1 Port 3456. Zum Lesen ist kein Modellaufruf nötig.
specweave reportWer was getan hat, als Seite
Eine HTML-Zeitleiste mit Tools, Sitzungen, Übergaben und Nachweisen in
reports/handoff-report.html.
Was das Dashboard für das Beispiel liest
| Increment | 0001-resumable-checkout Fortsetzbarer Checkout |
|---|---|
| Status | Aktiv |
| Aufgaben | 1 von 2 erledigt |
| Nächste Aufgabe | T-02 Entwurf bei Rückkehr wiederherstellen |
| Kriterien | AC-01 Wer innerhalb von 24 Stunden zurückkehrt, bekommt Warenkorb und Versandwahl wiederhergestellt. AC-02 Eine bezahlte Bestellung wird nie wiederhergestellt. |
| Dateien und Test | src/restore.js, npm test |
| Letzte Übergabe | claude@cloud, keine Tokens mehr. Übernommen von codex@laptop. |
Erstellt aus demselben specweave pickup-Lauf, der oben auf dieser Seite gezeigt wird. Führe specweave dashboard in deinem Projekt aus, um deines zu sehen.
Verbunden mit den Tools, die du schon nutzt
Jede ist optional und bleibt aus, bis du sie einrichtest.
Code-Navigation
$ specweave lsp refs src/restore.js restoreDraftReferenzen, Definitionen, Hover-Typen und Symbole von Language Servern, damit Agenten nicht mehr greppen.
LSP-Leitfadenspecweave lsp setupwählt Server für die Sprachen in deinem Repository.Jev
$ specweave jev route "<prompt>"Entscheidungen aus einer festen Auswahl in etwa 250 ms: welcher Skill oder welche Modellstufe, ob ein Shell-Befehl sicher auszuführen ist, ob abgerufener Text einen zweiten Blick braucht. Aktivieren mit
Über Jevspecweave jev setup.Projekt-Hub
$ specweave project briefEin gemeinsames Ziel, Kontext, Artefakte und Routinen in
Leitfaden für portable Projekte.specweave/project/hub.json, die jedes Tool liest.--harness codexexportiert das Briefing für ein anderes Tool.Bestehende Repositories
$ specweave get owner/repoKlont und registriert ein Repository im Workspace, oder mit
Leitfaden zur Workspace-Übernahme--alljedes Repository einer Organisation.--dry-runzeigt vorab, wie ein bereits vorhandener Checkout übernommen würde.Issue-Tracker
$ specweave sync pushOptional. Übertrage ein Increment nach GitHub Issues, Jira oder Azure DevOps, wenn dein Team dort plant.
Leitfaden zum Tracker-Sync
Dieselben Increments in einer Desktop-App ausführen
Ein SpecWithCode-Worker-Thread arbeitet auf einem Branch und öffnet einen Pull Request, genau die Form eines Increments. Seine Checkliste ist die Aufgabenliste des Increments, und seine Ledger-Einträge sind die Befehle auf dieser Seite. Threads hinterlassen einander Notizen im Ledger, statt gegenseitig Dateien zu bearbeiten.
SpecWithCode ansehen