This project addresses the need for isolated, parallel development environments for agentic workflows. It targets developers and researchers who need to manage multiple AI-driven coding tasks concurrently, offering benefits like contextual continuity, efficient A/B testing of approaches, and the ability to run long-duration, complex AI tasks.

How It Works

cmux enables parallel agentic development through isolated workspaces, supporting both local git worktrees and remote SSH clones. It integrates with multiple LLM providers, including OpenAI (GPT series), Anthropic (Sonnet, Opus), Ollama for local models, and OpenRouter for broader LLM access. The application features a custom agent loop, inspired by Claude Code, with modes like Plan/Exec and familiar UX elements, alongside novel features for efficient context management and interaction. This approach allows for concurrent exploration of different solutions, long-running AI tasks without interruption, and structured A/B testing of development strategies.

Quick Start & Requirements

• Primary install: Download pre-built binaries for macOS and Linux from the releases page.
• Prerequisites: No non-default prerequisites are explicitly listed.
• Status: The application is in a Preview state, and users may encounter bugs and performance issues.
• Integration: A VS Code Extension is available for seamless integration.

Highlighted Details

• Supports isolated development workspaces via local git worktrees and remote SSH clones.
• Integrates with multiple LLM providers including OpenAI (GPT series), Anthropic (Sonnet, Opus), local Ollama models, and OpenRouter.
• Features a custom agent loop inspired by Claude Code, offering Plan/Exec mode, vim inputs, and opportunistic compaction for efficient context management.
• Renders rich markdown outputs, supporting Mermaid diagrams and LaTeX for complex proposals.
• Provides a Git divergence UI to track changes and potential conflicts, alongside cost and token consumption monitoring.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels (like Discord/Slack) are provided in the README. The project is developed by Coder Technologies, Inc.

Licensing & Compatibility

• License type: GNU Affero General Public License v3.0 (AGPL-3.0).
• Compatibility: AGPL-3.0 is a strong copyleft license. It requires that any modifications or derivative works distributed must also be made available under the AGPL-3.0. This may impose restrictions on linking with closed-source software or using it in commercial services without open-sourcing the service.

Limitations & Caveats

cmux is currently in a Preview state, meaning users should expect bugs and performance issues. While usable for development, it is not yet considered stable.