Vibemux

VibeMux

A TUI-based AI Agent Orchestration Terminal for Vibe Coding

English | 中文

Overview

VibeMux is a Terminal User Interface (TUI) application designed for orchestrating and managing multiple AI coding agents. Think of it as lazydocker or k9s, but for Claude Code and Codex instances.

VibeMux enables developers to:
- Run multiple AI agent sessions in parallel
- Monitor and interact with agents through a unified interface
- Manage different configurations (Profiles) for different projects
- Switch seamlessly between agent sessions

Features

- Multi-Pane Layout: View and manage up to 9 agent sessions simultaneously (3x3 grid)
- Profile Management: Create and switch between different configurations
- Multi-Driver Support: Run claude, codex, or ccr with per-profile commands
- PTY Integration: Full terminal emulation with ANSI support
- Non-Intrusive: Uses environment variable injection, no modification to global configs
- IME Support: Chinese input method (Pinyin) compatibility
- Smart Notifications: Desktop notifications + optional webhooks
- Auto-Approve: Configurable auto-approval for common prompts

Requirements

- Go 1.25 or higher (for building from source)
- Claude Code CLI (claude) or Codex CLI (codex) installed
  - Claude Code: npm install -g @anthropic-ai/claude-code
- macOS / Linux (Windows supported via WSL; native Windows is experimental)

Installation

Quick Install (macOS / Linux / WSL)

Installs to ~/.local/bin by default. Override with INSTALL_DIR=/path.

Go Install (macOS / Linux / WSL)

From Source

Quick Start

1. First Run Setup

   On first launch, VibeMux will guide you through initial setup:
   - Configure the path to Claude Code CLI
   - Create a default profile

2. Add a Project

   Press a to add a new project:
   - Enter project name
   -…