Installation

MuxPilot is a single Rust binary named muxpilot. Build it from the workspace or install it onto your PATH with cargo.

Requirements

• Rust 1.75+ (stable) with cargo.
• tmux 3.3+ — MuxPilot drives tmux directly.
• fzf — optional, only needed for the --fzf picker fallback.
• zoxide — optional, enables frecent-directory discovery.

Build from source

Clone the repository and build the muxpilot crate in release mode:

git clone https://github.com/yatsyk/muxpilot
cd muxpilot
cargo build --release -p muxpilot

The binary lands at target/release/muxpilot. Run it straight from there, or put it on your PATH:

# Symlink into a directory already on PATH
ln -sf "$PWD/target/release/muxpilot" ~/.local/bin/muxpilot

# Verify
muxpilot --help

Install with cargo

To install the binary into your cargo bin directory (~/.cargo/bin), run cargo install against the crate path:

cargo install --path crates/muxpilot

Once published to crates.io this becomes:

cargo install muxpilot

Verify the environment

MuxPilot ships a doctor command that checks tmux, fzf, and the current tmux context so you can confirm everything is wired up:

muxpilot doctor
muxpilot doctor --json   # machine-readable

Development

To work on MuxPilot itself, use the standard cargo workflow:

cargo test
cargo run -p muxpilot -- --help

Next: wire it into tmux as a plugin, or explore the CLI reference.