Was ist workmux?
workmux macht aus einem Branch einen Arbeitsplatz. Ein einziges workmux add legt einen git-Worktree an, öffnet das passende tmux-Fenster, kopiert die Dateien, die einem frischen Checkout fehlen (.env, Zugangsdaten), verlinkt die, die man nicht neu installieren will (node_modules), führt die Setup-Befehle aus und baut das gewünschte Pane-Layout auf. workmux merge nimmt alles in einem Schritt zurück: Branch mergen, Worktree löschen, Fenster schließen, lokalen Branch entfernen. Kein Stashen, kein Branch-Wechsel, kein halbfertiger Checkout, der die nächste Aufgabe blockiert.
⚡ Hauptfunktionen von workmux
🌿 Ein Fenster pro Branch
workmux add legt Worktree und tmux-Fenster gemeinsam an, Aufgabenwechsel ist damit ein Tab-Wechsel, mit eigener Shell, eigenem Editor und eigenem Dev-Server.
🧰 Worktrees, die wirklich laufen
Frische Worktrees starten kaputt. workmux kopiert Konfigurationsdateien, verlinkt Abhängigkeiten und führt deine post_create-Befehle aus, damit der neue Checkout sofort benutzbar ist.
🤖 Agenten parallel
Mehrere KI-Coding-Agenten gleichzeitig laufen lassen, einen pro Worktree, und ihren Status im tmux-Fensternamen, in einem TUI-Dashboard oder in einer Live-Sidebar verfolgen.
🧹 Aufräumen mit einem Befehl
workmux merge merget den Branch und entfernt danach Worktree, tmux-Fenster und lokalen Branch; workmux remove räumt auf, ohne zu mergen.
📄 In YAML konfiguriert
Eine globale config.yaml für deine Standards und eine .workmux.yaml pro Projekt für Pane-Layouts, Hooks und Dateioperationen, mit Verschachtelung für Monorepos.
🖥️ Nicht nur tmux
tmux ist das Standard-Backend, kitty, WezTerm und Zellij sind unterstützte Alternativen, der Workflow folgt also dem Terminal, das du ohnehin benutzt.
apt upgrade hält dich auf der neuesten Version.
📦 Installation aus deb.griffo.io
Schritt 1: Repository hinzufügen
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update🆓 Es gibt einen für immer kostenlosen Spiegel. deb-free.griffo.io liefert Pakete für immer kostenlos — ohne Konto, ohne Abo, höchstens 2 Monate hinter Upstream, Sicherheitsfixes sofort. Derzeit enthält er cliamp, Ghostty, lazydocker, Oh My Posh und Zed; workmux ist nicht dabei, deshalb führt heute nur das Repository oben dorthin — auf Anfrage kann es aufgenommen werden.
Schritt 2: workmux installieren
# Neuestes workmux installieren
sudo apt install workmux
# tmux ist das Standard-Backend und nur empfohlen,
# denn kitty, WezTerm und Zellij funktionieren ebenfalls
sudo apt install tmux
# Installation prüfen
workmux --version# Neuestes workmux installieren
apt install workmux
# tmux ist das Standard-Backend und nur empfohlen,
# denn kitty, WezTerm und Zellij funktionieren ebenfalls
apt install tmux
# Installation prüfen
workmux --versionSchritt 3: Der erste Worktree
# Optional: eine .workmux.yaml für dieses Projekt schreiben
cd ~/src/mein-projekt
workmux init
# Aus tmux heraus: Branch, Worktree, Fenster und Panes in einem Befehl
workmux add neues-feature
# Wenn die Arbeit fertig ist: mergen und alles aufräumen
workmux merge
# bash-, zsh- und fish-Vervollständigungen liegen dem Paket bei
workmux --help🎯 Grundlegende Verwendungsbeispiele
Der Alltagsablauf:
# Branch, Worktree und tmux-Fenster anlegen
workmux add fix-login
# Ein bestehender Branch wird am Namen erkannt
workmux add bestehende-arbeit
# Von einer anderen Basis als der Standardbasis abzweigen
workmux add hotfix --base production
# Einen Pull Request in einen eigenen Worktree holen
workmux add --pr 123
# Alles Laufende ansehen
workmux list
# Mergen und alles abbauen
workmux merge
# Oder die Arbeit ohne Merge verwerfen
workmux remove fix-loginFenster, Panes und Wiederherstellung:
# Das Fenster anlegen, ohne hinzuwechseln
workmux add doku-durchgang --background
# Ein Fenster schließen, Worktree und Branch behalten
workmux close doku-durchgang
# Später wieder öffnen
workmux open doku-durchgang
# Nach einem tmux- oder Rechnerabsturz alle Fenster wiederherstellen
workmux resurrect
# Von überall in einen Worktree wechseln
cd "$(workmux path fix-login)"Agenten parallel laufen lassen:
# Status-Hooks und Skills für deinen Agenten installieren
workmux setup
# Einen Worktree mit einem Prompt für den Agenten starten
workmux add add-tests --prompt "Unit-Tests für den Parser ergänzen"
# Alle Agenten in einer TUI beobachten
workmux dashboard
# Oder eine Live-Status-Sidebar in tmux behalten
workmux sidebar
# Einem laufenden Agenten eine Anweisung schicken
workmux send add-tests "Auch die Fehlerpfade abdecken"
# Warten, bis dieser Agent fertig ist
workmux wait add-tests🔧 Werkzeug-Integrationen
workmux setzt bewusst auf die Werkzeuge, die du schon benutzt:
- git: Worktrees sind ganz normale
git worktree-Checkouts,git, deine Hooks und deine CI sehen nichts Ungewöhnliches - tmux: ein Fenster pro Worktree, benannt nach dem Branch, mit automatisch angewandtem Pane-Layout
- kitty, WezTerm und Zellij: unterstützte alternative Backends, falls tmux nicht dein Multiplexer ist
- Coding-Agenten: Statusverfolgung, Prompt-Einspeisung und Skills für Claude Code und die weiteren von upstream unterstützten Agenten
- Deine Shell: bash-, zsh- und fish-Vervollständigungen liegen diesem Paket bei, und
alias wm='workmux'ist die von upstream empfohlene Kurzform
🚀 Warum deb.griffo.io?
- Offizielles Ubuntu: paketiert workmux nicht,
apt install workmuxschlägt auf einem Standardsystem fehl - cargo install workmux: aktuell, aber ein Rust-Build auf jeder Maschine, außerhalb von apt und ohne die Shell-Vervollständigungen
- Das Upstream-Installationsskript: bequem, aber es schreibt am Paketmanager vorbei ins System und aktualisiert sich nach eigenem Zeitplan
- deb.griffo.io: neueste Version mit automatischen Updates
- ✅ Die einzige apt-Quelle: workmux ist weder in den Debian- noch in den Ubuntu-Archiven; dieses Repository paketiert den offiziellen Upstream-Build
- ✅ Agenten-Unterstützung ändert sich wöchentlich: welche Agenten workmux verfolgen und steuern kann, ändert sich von Release zu Release, aktuell zu sein entscheidet also darüber, ob die Funktion existiert
- ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach dem Upstream-Release aktualisiert
- ✅ Vollständiges Paket: das Upstream-Binary als
/usr/bin/workmuxplus bash-, zsh- und fish-Vervollständigungen - ✅ Ehrliche Abhängigkeiten: das Paket hängt von
gitab und empfiehlttmux, weil kitty, WezTerm und Zellij ebenfalls unterstützte Backends sind - ✅ Zwei Architekturen: amd64 und arm64, beide statisch gelinkt, dasselbe Paket läuft damit auf jeder Suite
- ✅ Multi-Distribution: läuft auf Ubuntu 22.04, 24.04, 25.10 und 26.04
- ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen
📦 Paket-Build-Repository
Die Ubuntu-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:
- 🧩 workmux-debian - Builds der neuesten Releases
🔗 Verwandte Pakete
Ebenfalls verfügbar über deb.griffo.io:
- lazygit - Terminal-git-UI für die git-Arbeit in jedem Worktree
- GitUI - Ein weiterer schneller Terminal-git-Client, falls dir sein Modell lieber ist
- Zellij - Unterstützte Alternative zu tmux als Multiplexer-Backend
- Serie - Commit-Graph, um nachzulesen, was ein Branch tatsächlich getan hat