Welcome to CodeMux

CodeMux is a specialized terminal multiplexer designed for "vibe coding" - a development approach where LLMs are the primary driver of code generation rather than direct typing.

What makes CodeMux different?

Unlike generic terminal multiplexers, CodeMux is purpose-built for AI-assisted development:

🎯 Smart Prompts: Detects and intercepts interactive prompts to provide native web UI components
🌐 Rich Interfaces: Provides web UIs instead of raw terminal emulation
🚀 Claude Code Ready: Optimized integration with Claude Code for seamless AI development
📱 Cross Platform: Works on desktop, web browsers, with mobile support in development

Installation

Homebrew (macOS/Linux)

brew install codemuxlab/tap/codemux

From Source

git clone https://github.com/codemuxlab/codemux-cli
cd codemux-cli
cargo build --release

Quick Start

Quick Mode

Launch a single AI session immediately:

# Start Claude
codemux claude

# Continue from previous session
codemux claude --continue

# Open with web interface
codemux claude --open

Server Mode

Run as a background service managing multiple sessions:

# Start the server
codemux server start

# Add a project
codemux add-project /path/to/project

# List active sessions
codemux list

# Attach to a session
codemux attach <session-id>