🧩 Install Latest workmux on Ubuntu

What is workmux?

workmux turns one branch into one workspace. A single workmux add creates a git worktree, opens a matching tmux window, copies the files a fresh checkout is missing (.env, credentials), symlinks the ones you do not want to reinstall (node_modules), runs your setup commands and lays out the panes you asked for. workmux merge undoes all of it in one step: merge the branch, delete the worktree, close the window, drop the local branch. No stashing, no branch switching, no half-finished checkout blocking the next task.

⚡ Key Features of workmux

📦 Installation from deb.griffo.io

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 update

install -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

# Install latest workmux
sudo apt install workmux

# tmux is the default backend and is only Recommended,
# because kitty, WezTerm and Zellij also work
sudo apt install tmux

# Verify installation
workmux --version

# Install latest workmux
apt install workmux

# tmux is the default backend and is only Recommended,
# because kitty, WezTerm and Zellij also work
apt install tmux

# Verify installation
workmux --version

# Optional: write a .workmux.yaml for this project
cd ~/src/my-project
workmux init

# From inside tmux: branch, worktree, window and panes in one command
workmux add new-feature

# When the work is done: merge and clean everything up
workmux merge

# bash, zsh and fish completions ship with the package
workmux --help

🎯 Basic Usage Examples

The everyday loop:

# Create a branch, a worktree and a tmux window
workmux add fix-login

# An existing branch is picked up by name
workmux add existing-work

# Branch off something other than the default base
workmux add hotfix --base production

# Check out a pull request into its own worktree
workmux add --pr 123

# See everything in flight
workmux list

# Merge and tear it all down
workmux merge

# Or throw the work away without merging
workmux remove fix-login

Windows, panes and recovery:

# Create the window without switching to it
workmux add docs-pass --background

# Close a window but keep the worktree and branch
workmux close docs-pass

# Open it again later
workmux open docs-pass

# Rebuild every window after a tmux or machine crash
workmux resurrect

# cd into a worktree from anywhere
cd "$(workmux path fix-login)"

Running agents in parallel:

# Install the status hooks and skills for your agent
workmux setup

# Start a worktree with a prompt for the agent
workmux add add-tests --prompt "Add unit tests for the parser"

# Watch every agent in one TUI
workmux dashboard

# Or keep a live status sidebar in tmux
workmux sidebar

# Send an instruction to a running agent
workmux send add-tests "Also cover the error paths"

# Block until that agent is done
workmux wait add-tests

🚀 Why Choose deb.griffo.io?

• ✅ The Only apt Source: workmux is in neither the Debian nor the Ubuntu archives; this repository packages the official upstream build
• ✅ Agent Support Moves Weekly: which agents workmux can track and drive changes release by release, so being current is the difference between the feature working and not existing
• ✅ Automatic Updates: packages updated within hours of upstream releases
• ✅ Complete Package: the upstream binary as /usr/bin/workmux plus bash, zsh and fish completions
• ✅ Honest Dependencies: the package depends on git and recommends tmux, because kitty, WezTerm and Zellij are supported backends too
• ✅ Two Architectures: amd64 and arm64, both statically linked, so the same package runs on every suite
• ✅ Multi-Distribution: works on Ubuntu 22.04, 24.04, 25.10 and 26.04
• ✅ Easy Maintenance: standard apt commands for updates

📦 Package Build Repository

The Ubuntu packages are automatically built and maintained in this GitHub repository:

• 🧩 workmux-debian - Latest release builds

🔗 Related Packages

Also available from deb.griffo.io:

• lazygit - Terminal UI for the git work inside each worktree
• GitUI - Another fast terminal git client, if you prefer its model
• Zellij - A supported alternative to tmux as the multiplexer backend
• Serie - Commit graph for reviewing what a branch actually did