muxac

muxac

Multiplexer for Agentic Coding tools

Overview

muxac provides three primitive features to manage sessions of Agentic Coding tools:

• muxac new: Creating a new session
• muxac list: Listing all sessions with their status
• muxac attach: Attaching to an existing session

Using these primitives, you can also build your own tools like a dashboard or UI on top of muxac.

For example, the creator of muxac uses it with fzf and Neovim to switch between sessions of Claude Code while previewing them as shown below:

Usage

# Create a new Agentic Coding session for the current directory with an Agentic Coding tool command like `claude`.
$ muxac new claude

# You can detach from the session by pressing `Ctrl+b d`.

# List all sessions with their status.
$ muxac list

DIRECTORY               NAME     STATUS
/path/to/workspace-1    default  running
/path/to/workspace-2    foo      waiting
/path/to/workspace-3    bar      stopped

# Attach to an existing session for the current directory.
$ muxac attach

Installation

Download the binary from the release page.

Prerequisites

• tmux

Setup

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ],
    "PermissionRequest": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "muxac hook"
          }
        ]
      }
    ]
  }
}

Command Reference

muxac new

Creates a new tmux session and launches the specified agentic coding tool.

$ muxac new [--name <name>] [--dir <path>] [--env KEY=VALUE ...] [--tmux-conf <path>] <command>

muxac list

Lists all muxac sessions with their status.

$ muxac list [--no-header] [--json]

$ muxac list
DIRECTORY          NAME     STATUS
/home/user/myapp   default  running
/home/user/api     backend  waiting

muxac attach

Attaches to an existing tmux session.

$ muxac attach [--name <name>] [--dir <path>]