⛔ Not accepting public PRs at this time

Muster

Terminal session group management built on tmux. A Rust library and CLI for organizing terminal sessions into named, color-coded groups with saved profiles, runtime theming, and push-based state synchronization via tmux control mode.

Prerequisites

• tmux — installed and available in PATH
• Rust — 2024 edition (for building from source)

Installation

cargo install muster-cli

Or from source:

cargo install --path crates/muster-cli

Quick Start

muster profile save myproject --tab 'Shell:~/work/myproject' --color '#f97316'
muster up myproject
# You're inside a tmux session. Detach with Ctrl-b d.
muster status           # check what's running
muster up myproject     # reattach
muster down myproject   # tear down

Documentation

Full documentation is available at scott2b.github.io/muster/:

• User Guide — concepts, profiles, sessions, and features
• CLI Reference — complete command docs
• Architecture — design and tmux interface
• API Reference — rustdoc for the library crate

Building Docs Locally

mdbook serve docs                    # user guide
cargo doc --no-deps --open           # API reference

Development

cargo nextest run                    # unit tests
cargo nextest run --run-ignored all  # integration tests (requires tmux)
cargo clippy                         # lint
cargo fmt --check                    # format check