jumpmux

jumpmux brings Git worktrees, Pi agents, and tmux sessions into one TUI for navigation and management.

Inspired by workmux and sesh.

Features

Agents

Open Pi panes with Project, Worktree, Git, PR, Status, Time, and Title columns.

Worktrees

View worktrees from the current repository with Project, Worktree, Git, PR, Mux, Age, and Agent columns.

Sessions

Browse configured locations, discovered repositories, and live tmux sessions with Session, Path, Windows, and Last-attached columns.

Requirements

• Go 1.24+ to install from source
• git
• tmux
• Pi
• Optional: Nerd Font, Worktrunk, GitHub CLI

Install

Download the Linux or macOS archive for your amd64 or arm64 system from GitHub Releases, extract jumpmux into your PATH, then run:

jumpmux setup

To install from source instead:

go install github.com/raphapr/jumpmux@latest
jumpmux setup

jumpmux setup installs or updates jumpmux-status.ts in Pi's global extensions directory. Run it again after upgrading jumpmux, then restart Pi or run /reload in each open Pi session.

The extension reports each pane's lifecycle state for the dashboard.

Quick start

jumpmux

Documentation

• Dashboard: keys, actions, previews, Git status, pull requests, and themes
• Command line: commands and confirmation behavior
• Configuration: config file reference, backends, previews, sessions, and agent attention
• Development: source layout and release process

Scope

jumpmux is a opinionated TUI for navigating and managing Git worktrees, Pi agents, and tmux sessions. It reads related state, switches sessions, manages worktrees, and opens PRs.

It does not orchestrate agents or multi-agent workflows. Also, it supports only Pi as AI agent and tmux as terminal multiplexer.