Ein Stellwerk für deine KI-Agenten
Freigaben für Claude Code und Codex auf dem zweiten Bildschirm erteilen
Jede laufende Sitzung von Claude Code und Codex auf einem breiten zweiten Bildschirm. Freigabeanfragen zeigen ihre vollständige Eingabe und lassen sich direkt dort erlauben oder ablehnen; die App arbeitet weiter, und wer zuerst entscheidet, gilt.
- Stabil
- Version 0.5.1
- Apache-2.0
- Windows 10 & 11
- Claude Code
- Codex
Das Problem
Lange Läufe halten an einem Fenster, das du nicht siehst.
Lange Agentenläufe bleiben an einer Freigabeanfrage hängen, deren Fenster gerade verdeckt ist.
Mehrere Sitzungen gleichzeitig sind schwer im Blick zu behalten.
Automatische Freigaben sparen Klicks, kosten aber Kontrolle.
Funktionen
Was es kann
Jede Sitzung im Blick
Name, Projekt und Status jeder Sitzung, die Zahl laufender Subagenten und wie voll ihr Kontext ist. Das Dringendste zuerst.
Anfragen mit vollständiger Eingabe
Ein Shell-Befehl vollständig, eine Dateiänderung mit Pfad und Inhalt, ein MCP-Aufruf mit Server, Werkzeug und Parametern. Erlauben, ablehnen oder der App überlassen.
Die App arbeitet wie bisher
Die Claude-App zeigt gleichzeitig ihre eigene Karte; wer zuerst entscheidet, gilt. Ohne Entscheidung am Display übernimmt die App nach 60 Sekunden, bei Codex nach 30.
Was auf dich wartet
Fragen und Eingaben, auf die die Agenten in der App warten, stehen in einer Liste, mit der Wartezeit.
Wenn du möchtest
Offene Pull Requests mit ihren Actions-Läufen, Auslastung und Temperatur der Hardware, deine Uptime-Kuma-Monitore und wie viel der Limits deiner Pläne verbraucht ist.
Nur lokal
Der Hub lauscht auf 127.0.0.1 und nirgends sonst. Das Display lädt nichts aus dem Internet.
Wie eine Anfrage läuft
| Schritt | Was passiert |
|---|---|
| 1 | Claude Code oder Codex bittet um eine Freigabe und schickt die Anfrage über einen Hook an den Stellwerk-Hub. |
| 2 | Das Display zeigt sie als Karte. Die Claude-App zeigt gleichzeitig ihre eigene, die Codex-App erst, wenn Stellwerk geantwortet hat. |
| 3 | Am Display erlaubst du, lehnst ab oder gibst die Anfrage an die App ab. Bei Claude Code kannst du auch in der App antworten; wer zuerst entscheidet, gilt. |
| 4 | Ohne Entscheidung am Display übernimmt die App: bei Claude Code nach 60 Sekunden, bei Codex nach 30. Läuft der Hub nicht, fragen beide einfach in der App. |
Sicherheit
- Feste Adresse 127.0.0.1, dazu eine Regel der Windows-Firewall als zweite Schicht.
- Jede Hook-Anfrage braucht ein Token; das Display meldet sich an, bevor es etwas bekommt.
- Nichts wird automatisch erlaubt: keine Regeln, kein „immer erlauben“.
- Verbindungen zu anderen Rechnern nur zu api.github.com und deinem Uptime Kuma, jeweils erst, wenn du es einrichtest.
Installieren
Installation
Voraussetzungen
- Windows 10 oder 11
- Node.js 24 (LTS)
- Claude Code: die Claude-Desktop-App oder die Kommandozeile
- Codex, wenn du möchtest: die Codex-App
- Microsoft Edge oder ein anderer Chromium-Browser für das Display
Aus einem Release
Lade stellwerk-VERSION.zip und SHA256SUMS aus dem neuesten Release. In PowerShell, mit der heruntergeladenen Version:
(Get-FileHash stellwerk-VERSION.zip).Hash # muss der Zeile in SHA256SUMS entsprechen
gh attestation verify stellwerk-VERSION.zip --repo Azentrius/stellwerk
Expand-Archive stellwerk-VERSION.zip -DestinationPath .
cd stellwerk-VERSION
npm ci --omit=dev
npm link
Claude Code verbinden
- Starte den Hub:
stellwerk serve. Beim ersten Start legt er das Token für die Hooks an. - Verbinde Claude Code:
stellwerk hooks install. Es zeigt, was es zu deinen Einstellungen hinzufügt, und fragt vor dem Schreiben. - Starte die Claude-Desktop-App und alle Terminals neu, in denen Claude Code läuft.
- Einmal als Administrator:
stellwerk installlegt die Firewall-Regel an. - Öffne das Display auf dem zweiten Bildschirm. Damit alles mit Windows startet:
stellwerk autostart install.
Codex verbinden (optional)
Stellwerk zeigt auch die Sitzungen der Codex-App, markiert mit „Codex“, und beantwortet ihre Freigaben am Display:
stellwerk codex install
Es zeigt, was es zu den Hooks von Codex hinzufügt, und fragt vor dem Schreiben. Starte die Codex-App neu und erlaube dort die neuen Hooks: Das Hook-Symbol im Eingabefeld öffnet Review hooks. Erst danach führt Codex sie aus.
Was bei Codex anders ist als bei Claude Code:
- Die Codex-App zeigt ihre eigene Freigabekarte erst, wenn Stellwerk geantwortet hat. Darum wartet eine Codex-Anfrage 30 Sekunden am Display (einstellbar von 10 bis 35) und geht dann an die App; In der App gibt sie sofort ab.
- Mit „Approve for me“ entscheidet der eigene Prüfer von Codex; Stellwerk hält dann nichts an und zeigt keine Karte.
- Läuft der Hub nicht, fragt Codex wie gewohnt.
stellwerk codex uninstall entfernt genau diese Hooks. Alles zu Codex steht im README unter Codex.
Das README beschreibt den Rest: Pull Requests, Hardwarewerte und Uptime Kuma.
Fragen
Funktioniert es mit der Claude-Desktop-App?
Ja, mit Claude Code in der Desktop-App und auf der Kommandozeile. Die App zeigt ihre eigene Karte, und die erste Entscheidung gilt.
Funktioniert es mit Codex?
Ja, mit der Codex-App, nach stellwerk codex install. Eine Codex-Anfrage wartet 30 Sekunden am Display und geht dann an die App, weil die App ihre eigene Karte erst danach zeigt; „In der App“ gibt sie sofort ab.
Was passiert, wenn der Hub nicht läuft?
Claude Code und Codex fragen einfach in der App, ohne Fehlermeldungen.
Kann es Anfragen automatisch erlauben?
Nein. Es gibt keine Regeln und kein „immer erlauben“.
Welches Display brauche ich?
Es ist für 1920×720 gemacht und bereit für Touch; ein Faktor skaliert alle Größen für andere Bildschirme.
Läuft es unter macOS oder Linux?
Noch nicht: nur Windows 10 und 11.
Sendet es Daten ins Internet?
Nein, außer an api.github.com für Pull Requests und an dein eigenes Uptime Kuma, jeweils nur, wenn du es einrichtest.
Was es unterscheidet
Andere Werkzeuge bringen Freigaben aufs Handy oder per Push, manche mit automatischer Freigabe. Stellwerk bleibt auf deinem Schreibtisch und auf deinem Rechner und gibt nichts von selbst frei.