Roost: Eine einzelne Go-Binär-Seitenleiste für Claude Code mit klickbarer Eingabehistorie, Dateibaum und Benachrichtigungen

Ein Entwickler hat Roost entwickelt, um drei Lücken bei der Nutzung von Claude Code über SSH via tmux zu schließen: anklickbaren Prompt-Verlauf, einen Dateibaum zum Reduzieren von cat-Aufrufen und Push-Benachrichtigungen, wenn Claude wartet. Es ist ein einzelnes Go-Binary, das ein Web-Interface auf 127.0.0.1:8080 bereitstellt, ausgelegt für SSH-Tunneling.

Hauptfunktionen

• xterm.js-Terminal mit tmux-Unterstützung: Überlebt WebSocket-Verbindungsabbrüche, Ruhezustand und Server-Neustarts. Jede Sitzung ist tmux new-session -A -s {id}.
• Dateibaum: Dateienvorschau, Drag-and-Drop-Upload und folgt automatisch Ihrem aktuellen Verzeichnis durch Auslesen von tmux' pane_current_path – keine Shell-Integration erforderlich.
• Aktivitätsfenster: Liest ~/.claude/projects/*.jsonl und zeigt jeden Prompt an. Klick auf einen Prompt → Terminal scrollt zu diesem Schritt zurück.
• Top-Leiste-Chips: Zeigen aktives Modell und aktuelle Kontext-Token an.
• Push-Benachrichtigungen: Nutzt Claude Codes Stop-Hook, um Ihr Laptop zu benachrichtigen, wenn Claude inaktiv wird, selbst wenn der Tab im Hintergrund ist.

Design-Entscheidungen

• tmux als Haltbarkeitsschicht: Die Shell überlebt Verbindungsabbrüche und Neustarts, da tmux die Sitzungspersistenz übernimmt. Roost besitzt nur eine WebSocket-Brücke und ein Append-Only-Disk-Log.
• Single-User-pro-Instanz: Keine Konten oder RBAC. Zwei Personen, die sich einen Host teilen, starten jeweils roost serve auf einem anderen Port. UNIX-UIDs kümmern sich um Isolation; Reverse-Proxys um Multi-Tenant-Auth.
• Vanilla JS, kein Build-Schritt: Frontend besteht aus einfachen <script>-Dateien, die via //go:embed all:web eingebettet werden. Kein Bundler – einfacher zu debuggen und auszuliefern.

Beachtenswerter Bugfix

tmux' display-message -p '#{x}\x1f#{y}' gibt 0x1f als wörtlichen Unterstrich zurück, wenn es ohne UTF-8-Locale gestartet wird (z. B. aus systemd-Einheiten). Die einzeilige Lösung: tmux -u. Wenn Sie tmux durch Feldtrennzeichen leiten, fixieren Sie die Locale.

Kompatibilität

Getestet auf Linux-Server + Windows Chrome über SSH-Tunnel. macOS als Server funktioniert, hat aber kleine Probleme. Codex-Sitzungen funktionieren, wenn Sie die Agenten tauschen. Repository: github.com/liamsysmind/roost. v0.1.0-Tarballs unter github.com/liamsysmind/roost/releases/tag/v0.1.0.