Introducing muxtree: Dead-Simple Worktree + Tmux Sessions for AI Coding

Source: Dev.to

Overview

There are already tools for managing parallel AI coding sessions—e.g., the Codex app and projects like Conductor. While useful, they are opinionated and often over‑engineered for simple workflows.

muxtree is a single Bash script that pairs Git worktrees with tmux sessions, giving you a lightweight way to run multiple agents side‑by‑side. It works with any Claude Code or Codex CLI already installed on your machine, without additional wrappers or abstractions.

Installation

# Copy the script to a location on your $PATH and make it executable
cp muxtree /usr/local/bin/muxtree && chmod +x /usr/local/bin/muxtree

# Initialise the configuration (creates default directories, etc.)
muxtree init

No dependencies beyond git and tmux. No package manager required.

Usage

Create a new worktree + tmux session

muxtree new feature-auth --run claude

What you get:

• A Git worktree branched from main.
• Your .env, CLAUDE.md, and other specified files copied into the worktree.
• A tmux session with two windows:
  • dev – your development environment.
  • agent – Claude Code (or the specified CLI) already running.
• A terminal window attached to the session.

Switch between windows with the standard tmux shortcuts (Ctrl‑b n / Ctrl‑b p). Because tmux sessions persist, you can close the terminal, reopen later, and everything continues to run.

Re‑attach to an existing session

muxtree sessions close fix-bug           # walk away
muxtree sessions open fix-bug --run claude  # pick up where you left off

Other common commands

muxtree new fix-bug --run codex
muxtree list               # view all worktrees and sessions at a glance

Features

• No lock‑in – uses any CLI found on your $PATH.
• Configurable – choose where worktrees are stored, which terminal app to use, and which files to copy.
• Tab completion – available for both Bash and Zsh.
• Zero runtime dependencies beyond git and tmux.
• MIT licensed – a single script you can audit and modify.

License

MIT License.

Repository

https://github.com/b-d055/muxtree