FlowmuxFlowmux

Terminal-native AI agent multiplexer

Flowmux

Run, track, and switch between multiple CLI agents from one keyboard-first dashboard with tmux-backed persistence and real terminal sessions.

InstallDownload releaseView on GitHub
tmux panesreal CLI sessionsstatus hotkeysproject dashboards

Quick demo

A grid of active work, not a pile of hidden terminals.

Flowmux keeps the overview quiet: project dashboards, agent status, model information, and response previews are visible without leaving the terminal.

Animated Flowmux terminal dashboard demo

Why Flowmux

A calm control surface for parallel agent work.

Keyboard-first dashboard

Manage multiple CLI agents from one terminal UI with fast hotkeys for the work that needs attention.

Unix-style by design

Flowmux coordinates panes, projects, agents, and worktrees without trying to replace the tools you already trust.

Bring your own tools

Keep using your preferred editor, git UI, shell, terminal, and command-line utilities around every agent session.

Clean grid view

Track running, waiting, and idle agents with model information and latest-response previews in the overview.

Projects and worktrees

Separate work by repo, task, or stream, then give agents their own working directories and optional git worktrees.

Real terminal sessions

Agent, git viewer, and shell views forward keys into live tmux panes instead of wrapping the agent UI.

tmux-backed persistence

Saved session state lets Flowmux reconnect to agents after tmux restarts so long-running work is easier to resume.

Native Rust TUI

Built with Ratatui, Tokio, tmux, libghostty-vt, and git2 for a focused terminal application.

Typical workflow

Separate the work. Watch the grid. Jump to what needs attention.

  1. 01Create a project.

    Separate work by repo, task, or stream when you want distinct dashboards.

    p
  2. 02Add one or more agents.

    Create agents with separate working directories and optional isolated git worktrees.

    n
  3. 03Monitor the grid.

    Watch running, waiting, and idle agents from the dashboard without opening every terminal.

    h/j/k/larrows
  4. 04Jump to what needs attention.

    Move straight to running, waiting, or idle agents when the status changes.

    Ctrl+qCtrl+oCtrl+p
  5. 05Open the full agent terminal.

    Read output, respond, inspect git state, or open a persistent shell in the agent directory.

    EnterCtrl+vCtrl+t
  6. 06Resume later.

    Reopen Flowmux and continue from the saved session state after a restart.

    flowmux

Supported agents

Use the CLI agents already in your terminal.

Flowmux auto-detects installed agent CLIs and enables discovered agents by default unless you configure an explicit allowlist.

Install

Requires tmux and at least one supported agent CLI. Homebrew is the preferred path on supported systems.

Prebuilt Linux and macOS binaries are available on GitHub Releases.
brew install grouzen/tap/flowmux