deck

A tmux session sidebar that lives inside your terminal

Browse and switch agent sessions easily.

Install · Usage · Customize · Develop

---

deck is a tmux enhancement tool — the sidebar lists your sessions and agents.

✅ deck is	🚫 deck is not
A ratatui sidebar that lists, and lets you act on, your tmux sessions	A tmux replacement, a general system terminal app, or a window manager

💪 deck helps you	✋ deck does not help you
Browse, switch, agent sessions	Install or configure tmux, hook your agents

Install

brew install cross-entropy-ai/tap/deck

Or with curl:

curl -fsSL https://raw.githubusercontent.com/cross-entropy-ai/deck/main/install.sh | sh

Or download a pre-built binary from GitHub Releases.

Usage

deck

Note

Requires tmux installed and available on PATH. If there are no sessions, deck tries to create a detached session named default so it can start.

deck runs two panes. The sidebar lists your tmux sessions. The main pane stays attached to the focused session.

Configuration lives in ~/.config/deck/config.json.

Tip

Click a session to switch, right-click for a context menu (rename, kill, new session), or drag the edge between panes to resize.

Develop

cargo run

For implementation details, see the Architecture section of CLAUDE.md.

Build from source

cargo build --release
./target/release/deck

You still need tmux installed locally to run it.