Codemux

The Agentic Development Environment for Builders

---

Codemux is a Linux-first workspace that brings terminals, browser panes, and multi-agent orchestration into one app. Run coding agents side by side, review changes, test in-browser, and ship — without leaving the window.

Features

• Multi-workspace terminals — Split, resize, swap, and manage terminal sessions across isolated workspaces
• Browser panes — Embedded browser alongside your terminals for testing and agent-assisted browsing
• Git worktree isolation — Each workspace gets its own worktree so agents never interfere with each other
• Built-in diff review — See what changed, commit, and manage branches without switching tools
• Workflow orchestration — Run structured Claude workflows with approval, progress, summaries, and agent drill-in
• Notifications & attention signals — Know exactly when an agent needs you, with desktop notifications and per-pane indicators
• CLI & socket control — Automate everything via codemux CLI or the local Unix socket API
• Custom keybinds — Full keyboard-first workflow with a command palette and rebindable shortcuts

Install

AppImage (any Linux distro)

Download the latest .AppImage from Releases, make it executable, and run:

chmod +x Codemux-*.AppImage
./Codemux-*.AppImage

Requirements

• Linux (X11 or Wayland)
• git
• ydotool with ydotoold running — needed for browser automation
• A Chromium-based browser (Chromium, Google Chrome, or Brave) — for browser panes
• ripgrep — file content search
• fd — file name search
• GitHub CLI — PR creation and GitHub integration
• xdg-utils — open in file manager

Quick Start

1. Launch Codemux
2. Create a project by pointing it at a git repository
3. Create a workspace — each workspace gets an isolated git worktree
4. Open terminal panes, start your coding agent, and work

Split panes with keybinds, open a browser pane for testing, and use the changes panel to review diffs and commit when ready.

Outside agents (MCP)

Codemux is an MCP server. Claude Code, Codex, a Hermes chat bot, or any MCP client can drive it:

• open workspaces and create worktrees;
• start Codemux threads with a chosen provider, model and permission mode;
• send messages, wait for the result and read it;
• answer approvals and questions.

On this computer, with Codemux running:

claude mcp add --scope user codemux -- codemux mcp --client claude-code

From another device, run the same codemux mcp over SSH, or turn on Settings → Connections → Outside assistants → Over the network (or run codemux connector enable), put HTTPS in front of it, and sign in with OAuth or a token. Scripts can use the same tools with codemux call and the codemux thread commands.

docs/outside-agents.md covers per-client setup (including Hermes), the end-to-end flow, access levels and security. The MCP Server docs list every tool.

Build from Source

# Clone the repo
git clone https://github.com/Zeus-Deus/codemux.git
cd codemux

# Install dependencies
npm install

# Run in development mode
npm run tauri:dev

# Build for release
npm run tauri:build

System dependencies: Rust, Node.js, and the Tauri prerequisites for your distro.

License

Elastic License 2.0 — see LICENSE.md.