Open Source für deine Coding-Sessions
Ein klarer Ablauf.
Für deine KI-Agenten.
Deine Coding-Agents bekommen einen abgestimmten Plan, eine Prüfung nach jeder Änderungsrunde und eine Übergabe an die nächste Session.
Plane die Arbeit. Setze sie in geprüften Wellen um. Mach dort weiter, wo du aufgehört hast. Allein weichen Coding-Agents vom Plan ab, überschreiben sich gegenseitig Dateien und melden Arbeit als fertig, bevor sie geprüft ist. Session Orchestrator schließt diese Lücken auf Claude Code, Codex, Cursor und Pi.
Kostenlos · MIT-Lizenz · Kein eigenes Konto
Plan / Go / Close
Eine Session.
Ein nachvollziehbarer Ablauf.
Ein gemeinsamer Plan, klar verteilte Aufgaben und ein Abschluss, an den du beim nächsten Mal anknüpfen kannst.
„Füge dem Dashboard einen CSV-Export hinzu.“
Illustrativer Ablauf, kein Live-Bericht- 01
Plan
Erst verstehen, dann aufteilen.
Code, offene Issues und bestehende Tests prüfen. Das Ziel eingrenzen, bevor jemand Dateien ändert.
Export-Code lesenDatenzugriff prüfenTests sichtenZusammenführen: Ein gemeinsamer Plan für Export-Button, CSV-Format und Download. Die Schreibbereiche werden vorab zugeordnet.
- 02
Go
Unabhängig arbeiten. Gemeinsam prüfen.
OberflächeButton und leeren Zustand umsetzen.
DatenCSV-Ausgabe und Sonderzeichen behandeln.
Prüfen: Änderungen zusammenführen. Download, Format und Fehlerfälle testen. Befunde korrigieren, dann erneut prüfen.
Claude Code und Codex können unabhängige Aufgaben parallel ausführen. Cursor und Pi arbeiten sie nacheinander ab.
- 03
Close
Festhalten, was erledigt ist. Und was offen bleibt.
Erledigt CSV-Export umgesetzt und die vereinbarten Fälle geprüft.
Noch offen Frei wählbare Spalten als Folgeaufgabe festhalten.
Änderungen, Prüfnachweise und nächste Schritte bleiben für die nächste Session nachvollziehbar.
Die Aufgabe bestimmt den Umfang.
Housekeeping nutzt eine Welle, ein Feature drei, Deep fünf, das Ultradeep-Profil sieben. Die Wellen strukturieren die Arbeit; sie sind kein Grund, aus jeder kleinen Änderung ein großes Projekt zu machen.
Die erste Session in der Anleitung (Englisch)Was du bekommst
Weniger Aufpassen.
Mehr fertige Arbeit.
Jeder Teil schließt eine Lücke, die entsteht, wenn Agents allein arbeiten. Zuerst, was er dir bringt, dann, wie er funktioniert. Alles läuft auf deinem Rechner und schreibt reinen Text in dein Repository.
- Richtig anfangen
Wissen, woran du arbeitest.
Jede Session beginnt beim echten Stand deines Projekts, nicht bei einem Prompt, den du jedes Mal neu schreibst.
/sessionliest Git, offene Issues, die letzten Commits und den Bericht der letzten Session, empfiehlt einen Umfang und wartet auf deine Korrektur./plan,/brainstormund/grillhelfen, solange eine Idee noch unscharf ist. - Fehler früh finden
Fehler stoppen bei der nächsten Prüfung.
Ein kaputter Test fällt direkt nach der Arbeit auf, die ihn verursacht hat, nicht erst, wenn weitere Arbeit darauf aufbaut.
/goprüft jede Welle mit deinen Tests und dem Typecheck und macht Fehler zu Korrekturaufgaben; Lint und die volle Suite laufen vor dem Commit./closeprüft jeden geplanten Punkt gegen das, was passiert ist./debugsucht die Ursache, bevor jemand flickt. - Im Rahmen bleiben
Agents bleiben bei ihren Dateien.
Parallele Agents überschreiben sich nicht gegenseitig, und zerstörerische Befehle rutschen nicht durch.
Jeder Agent bekommt eine festgelegte Dateiliste, Überschneidungen werden vor dem Start abgelehnt. Ein Guard blockiert 12 Muster zerstörerischer Befehle, etwa harte Resets,
rm -rf, Force-Push undDROP TABLE, und warnt bei 4 weiteren. Echte Hooks auf Claude Code, Brücken auf Cursor und Pi. Auf Codex läuft der Befehls-Guard als Hook; die Dateiliste bleibt eine Anweisung. - Den Faden halten
Weitermachen, wo du aufgehört hast.
Ein Absturz, ein zugeklappter Laptop oder eine zweite Session im selben Ordner kosten dich nicht die Arbeit.
STATE.mdhält jede fertige Welle fest, also bietet die nächste/sessionan, dort fortzusetzen. Ein Lock mit Lebenszeichen verhindert, dass zwei Sessions im selben Checkout kollidieren./closelegt Offenes als Issues auf GitLab oder GitHub an. - Mitlernen
Es wird mit deinen Sessions besser.
Muster aus deinen eigenen Sessions werden zu Regeln, denen deine Agents beim nächsten Mal folgen, sobald du sie freigibst.
Jede Session hängt einen Bericht an.
/evolveschlägt Learnings mit einer Konfidenz vor,/reconcileentwirft daraus Regeln. Du liest jede einzelne und löschst, was dir nicht passt. Optional: Sessions und Learnings in einen Markdown-Notiz-Vault spiegeln. - Weiter schauen
Prüfen, testen und reviewen auf Abruf.
Derselbe Ablauf findet Probleme, nach denen du nicht gefragt hast, und zeigt, dass die App funktioniert.
Ein Discovery-Scan bei
/closemacht aus Befunden, die du bestätigst, Issues./teststeuert Web- und macOS-Abläufe von Anfang bis Ende,/ux-grillprüft eine laufende Web-App auf Barrierefreiheit und Layoutfehler, und/test-auditentfernt Tests, die nichts fangen./repo-auditund/harness-auditbewerten ein Repository anhand einer Checkliste,/persona-panellässt mehrere Reviewer-Personas dasselbe Ergebnis parallel lesen.
Für längere Läufe: /autopilot verkettet ganze Sessions und hält bei einem von 10 Abbruchkriterien an, /dispatcher empfiehlt das nächste freie Repository und reserviert es nach deiner Bestätigung, /portfolio fasst Issues, MRs und CI über die in deinem Notiz-Vault registrierten Repositories zusammen. Alle Befehle stehen in der Komponentenübersicht (Englisch).
Was zwischen /session und /close passiert
- LesenGit, Issues, die letzten Commits und frühere Sessions werden zu einer Übersicht mit Empfehlung.
- AbstimmenAn deinem Code ändert sich nichts, bis du den Umfang annimmst oder korrigierst.
- AufteilenDie Arbeit wird in Wellen geteilt: 1 für Housekeeping, 3 für ein Feature, 5 für tiefe Arbeit, 7 für das Ultradeep-Profil. Jede Welle bekommt ein Ziel und die Dateien, die sie schreiben darf.
- Ausführen und prüfenAgents mit getrennten Dateien arbeiten auf Claude Code und Codex parallel. Nach jeder Umsetzungswelle laufen deine Tests und der Typecheck; Fehler werden zu Aufgaben der nächsten Welle. Vor dem Commit in /close läuft das volle Test-, Typecheck- und Lint-Gate.
- AbschließenPlan und Ergebnis werden verglichen, die Änderungen committet, und Unfertiges wird zu Issues.
Von Bernhard Götzendorfer
Es begann mit
einer Notion-Seite.
Ich hatte dort 20–30 Prompts für unterschiedliche Projekte gesammelt. Vor jeder Session habe ich die passende Zeile gesucht, kopiert und wieder erklärt, wie ich arbeiten möchte.
Daraus wurde nach und nach Plan, Go, Close. Heute nutze ich den Ablauf auf meinem Mac M4 und auf dem M5 im Büro. Session Orchestrator ist das Werkzeug dazu.
Mehr über BernhardInstallation
Dein Tool.
Deine nächste Session.
Wähle deinen Installationsweg. Du brauchst Node.js 24 oder neuer und ein Git-Repository. Das Plugin ist kostenlos; die Kosten deines Coding-Tools bleiben davon unabhängig.
Claude Code
/plugin marketplace add Kanevry/session-orchestrator
/plugin install session-orchestrator@kanevry
Nur wenn ein Befehl fehlschlägt: Node-Abhängigkeiten einmal prüfen
Aktuelles Claude Code installiert die Node-Abhängigkeiten mit dem Plugin. Zum einmaligen Prüfen, oder falls das bei dir nicht passiert ist, den Befehl unten in einer Shell ausführen: er startet npm install nur, wenn die Abhängigkeiten fehlen. Danach Claude Code neu starten, falls er installiert hat.
claude plugin list --json
Suche den aktivierten Eintrag session-orchestrator@kanevry. Ersetze den Platzhalter unten durch dessen installPath. Fehlt der Eintrag oder ist er deaktiviert, kläre das zuerst über /plugin. Bei mehreren Treffern die aktive Installation prüfen.
cd "/absolute/installPath/from/the/list" && { [ -d node_modules/js-yaml ] && echo "dependencies present, nothing to do" || npm install; }
Codex CLI
git clone https://github.com/Kanevry/session-orchestrator.git
cd session-orchestrator && npm install
node scripts/codex-install.mjs
Braucht Codex CLI ab 0.144.4. Die Konfiguration steht in AGENTS.md. Öffne nach der Installation eine neue Aufgabe und prüfe die Plugin-Hooks über /hooks.
Wähle die Session-Orchestrator-Skills: $session-orchestrator:bootstrap, danach $session-orchestrator:session feature, $session-orchestrator:go und $session-orchestrator:close. Siehe die Anleitung zur ersten Session (Englisch).
Auf Codex blockieren die Bash-Guards, die Schreibgrenze nicht. Der Guard für zerstörerische Befehle und die übrigen Bash-Guards laufen als Hooks, und Codex hält sich an ihre Ablehnung. Die Schreibgrenze bleibt eine Anweisung, weil Codex Dateien über apply_patch ändert und der Scope-Guard das nicht liest. Die Workflows und Qualitätsprüfungen laufen weiterhin.
Cursor IDE
git clone https://github.com/Kanevry/session-orchestrator.git
cd session-orchestrator && npm install
node scripts/cursor-install.mjs /absolute/path/to/your/project
Zielprojekt. Gib den Projektpfad ausdrücklich an. Ohne Pfad verwendet der Installer das aktuelle Verzeichnis.
Pi
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi install npm:session-orchestrator
Dieser Weg installiert seine Abhängigkeiten selbst; die Klone für Codex CLI und Cursor brauchen einmal npm install.
Noch nicht eingerichtet? Die Anleitung (Englisch) führt dich durch Installation und Bootstrap.
Unter der Haube
Was durchgesetzt wird
und wo es aufhört.
Welche Prüfungen laufen, was sie absichern und wo ihre Grenzen liegen. Mit Quellen im Repository.
Prüfungen und ihre Quellen
Ein Teil des Schutzes läuft als Code, ein Teil besteht aus Anweisungen an den Agenten. Die Wirkung hängt vom Werkzeug und der Konfiguration ab.
| Behauptung | Quelle |
|---|---|
| Der Workflow legt den Schreibbereich jedes Agenten vor dem Start fest. | scripts/validate-wave-scope.mjs --assert-disjoint |
| Mit aktivem Scope-Hook auf Claude Code, Cursor oder Pi blockiert strict unterstützte Änderungen außerhalb des Bereichs, warn meldet sie und off deaktiviert die Prüfung. Codex setzt die Schreibgrenze nicht durch. | hooks/enforce-scope.mjs |
| Mit aktivem Hook für zerstörerische Befehle wenden Claude Code und Codex 12 blockierende und 4 warnende Regeln an. Cursor und Pi nutzen Brücken. | .orchestrator/policy/blocked-commands.json, 16 Regeln |
| Sub-Agenten sind angewiesen, Staging und Commits dem Koordinator zu überlassen. Das ist eine Ablaufregel. | .claude/rules/parallel-sessions.md, PSA-007 |
| Der Abschlussablauf verlangt für jeden geplanten Punkt einen Beleg. | skills/session-end/SKILL.md |
Unterstützte Tools und Grenzen
- Unabhängig und von der Community gepflegt. Nicht verbunden mit Anthropic, OpenAI oder Cursor und von keiner dieser Firmen unterstützt.
- Ausgeliefert wie es ist, ohne zugesicherte Reaktionszeiten, Pflege nach bestem Bemühen.
- Lokal per Default, ohne eigenes Konto. Optionale Nutzungsstatistik ist ausgeschaltet; die npm-Update-Abfrage lässt sich separat deaktivieren.
- macOS und Linux werden in der CI geprüft. Native Windows-Nutzung ist ungetestet; Shell-Hooks und der optionale MCP-Server brauchen WSL oder Git Bash.
- Eine Rangliste gibt es noch nicht, und auch keine Gesamtnote. Wo eine Zahl fehlt, steht das dort, statt zu raten. Eine Rangliste auf einer Messmethode, die noch nicht ehrlich ist, wäre schlechter als keine.
- Die Durchsetzung auf Hook-Ebene ist nicht auf jeder Umgebung gleich. Die Liste unten ist der aktuelle Stand, keine Roadmap. Die konfigurierten Qualitätsprüfungen laufen auf allen vier Werkzeugen.
| Claude Code | direkte Guard-Hooks; blockierende Scope-Prüfung braucht strict |
|---|---|
| Cursor IDE | Brücke für unterstützte Werkzeug- und Shell-Aufrufe; blockierende Scope-Prüfung braucht strict. Nachträgliche Prüfungen verhindern keine Änderung |
| Pi | Brücke für unterstützte Werkzeugaufrufe; blockierende Scope-Prüfung braucht strict |
| Codex CLI | Guard für zerstörerische Befehle läuft als Bash-Hook und blockiert; Regeln für Schreibbereiche sind nur Anweisungen, weil Änderungen über apply_patch laufen |
Repository-Zahlen mit Zählbeleg
v5.13.0
aktuelle Version
51
Skills
30
Slash-Befehle
14
typisierte Sub-Agenten
29
Hook-Dateien
775
Testdateien
253
Session-Aufzeichnungen im Repository
77
Learnings in diesem Repository
3342
npm-Downloads, letzte 30 Tage
53
GitHub-Sterne
Gezählt am 2026-10-20 bei Commit 95136cb8. Repository-Aufzeichnungen beschreiben Entwicklungsaktivität, keine aktiven Nutzer. Es zählen nur Sessions, die tatsächlich gelaufen sind, nicht jede Zeile im Session-Log; die Zahl ist deshalb kleiner als auf älteren Fassungen dieser Seite. npm-Downloads enthalten auch automatische Abrufe. Zählbeleg ansehen.
Häufige Fragen
Fragen, die Leute stellen
Ist das selbst ein Werkzeug, das Code schreibt?
Nein. Es ergänzt einen Ablauf zum Planen, Arbeiten und Prüfen der Ergebnisse. Den Code schreibt dein Code-Werkzeug. Welche Grenzen technisch durchgesetzt werden, hängt vom Werkzeug und der Konfiguration der Guards ab.
Mit welchen Werkzeugen läuft es?
Claude Code führt die Guard-Hooks direkt aus. Cursor und Pi nutzen Brücken mit dokumentierten Grenzen. Codex CLI bietet auswählbare Workflow-Skills und führt den Guard für zerstörerische Befehle als Bash-Hook aus, der blockiert; die Regeln für Schreibbereiche sind dort nur Anweisungen, weil Codex Dateien über apply_patch ändert und der Scope-Guard das nicht liest. Parallele Agenten gibt es auf Claude Code und Codex; Cursor und Pi arbeiten Aufgaben nacheinander ab.
Was ist der Unterschied zu Claude Code allein?
Es ergänzt einen wiederholbaren Ablauf: Projekt lesen, Umfang abstimmen, die Arbeit in Schritte mit festgelegten Dateien teilen und die Ergebnisse dazwischen prüfen. Der Session-Eintrag hält Fortschritt und offene Arbeit für die nächste Session fest.
Schickt es Daten irgendwohin?
Das Plugin läuft lokal ohne eigenes Konto. Optionale Nutzungsstatistik ist bis zu deiner Zustimmung ausgeschaltet. Beim Session-Start fragt es standardmäßig die npm-Registry nach Updates ab. Erfolgreiche Ergebnisse werden pro Repository 24 Stunden zwischengespeichert; schlägt die Anfrage oder das Speichern fehl, kann die nächste Session erneut anfragen. SO_DISABLE_UPDATE_CHECK=1 oder DO_NOT_TRACK=1 schaltet die Prüfung aus. Dein Code-Werkzeug und eingerichtete Dienste nutzen weiterhin ihre eigenen Netzwerkverbindungen. Diese Website nutzt cookiefreie Vercel Web Analytics, beschrieben in der Datenschutzerklärung.
Läuft es unter Windows?
macOS und Linux werden in der CI geprüft. Native Windows-Nutzung ist nicht getestet. Der Node-Kern nutzt portable Pfade, aber die Shell-Hooks und der optionale MCP-Server brauchen WSL oder Git Bash. Windows-Unterstützung erfolgt nach bestem Bemühen.
Was kostet es?
Nichts. Es ist kostenlos und Open Source unter der MIT-Lizenz. Was dein Code-Werkzeug kostet, zahlst du weiterhin; daran ändert sich nichts.
Kann es mein Projekt kaputt machen?
Fehler sind weiterhin möglich. Auf Claude Code und Codex wendet ein aktiver Hook für zerstörerische Befehle 12 blockierende und 4 warnende Regeln an. Cursor und Pi nutzen Brücken mit dokumentierten Grenzen. Codex setzt den Guard für Schreibbereiche nicht technisch durch. Bei unterstützten Änderungen mit aktivem Scope-Hook blockiert strict Verstöße, warn meldet sie und off deaktiviert die Prüfung. Prüfe Änderungen und halte Sicherungen vor; die Prüfungen garantieren keinen korrekten Code.
Wer pflegt das?
Ich, Bernhard Götzendorfer. Fragen und Fehlermeldungen auf GitHub beantworte ich selbst. Du kriegst es so, wie es ist. Ich pflege es, so gut es sich ausgeht, sage aber keine Antwortzeit zu.
Für dein nächstes Projekt
Fang mit einer
klaren Session an.
Installiere das Plugin und lass dein Repository lesen. Entscheide dann, was als Nächstes dran ist.