hub / github.com/coder/mux

github.com/coder/mux @v0.27.1-nightly.166 sqlite

repository ↗ · DeepWiki ↗ · release v0.27.1-nightly.166 ↗

15,499 symbols 57,584 edges 2,342 files 1,571 documented · 10%

README

mux logo

Mux - Coding Agent Multiplexer

Mux is a desktop & browser application for parallel agentic development. It enables developers to plan and execute tasks with multiple AI agents on local or remote compute.

mux product demo

Features

Isolated workspaces with central view on git divergence (docs)
Local: run directly in your project directory
Worktree: git worktrees on your local machine
SSH: remote execution on a server over SSH
Multi-model (sonnet-4-*, grok-*, gpt-5-*, opus-4-*)
Ollama supported for local LLMs (docs)
OpenRouter supported for long-tail of LLMs (docs)
VS Code Extension: Jump into Mux workspaces directly from VS Code (docs)
Supporting UI and keybinds for efficiently managing a suite of agents
Rich markdown outputs (mermaid diagrams, LaTeX, etc.)

Mux has a custom agent loop but much of the core UX is inspired by Claude Code. You'll find familiar features like Plan/Exec mode, vim inputs, /compact and new ones like opportunistic compaction and mode prompts.

Read the full documentation →

Install

Download pre-built binaries from the releases page for macOS and Linux.

Screenshots

_{Integrated code-review for faster iteration}	_{Agents report their status through the sidebar}
_{Git divergence UI keeps you looped in on changes and potential conflicts}	_{Mermaid diagrams make it easier to review complex proposals from the Agent}
_{Stay looped in on costs and token consumption}
_{Context management dialog keeps compaction controls in one place}
_{Mux server mode has a responsive UI for mobile users}

Development

See AGENTS.md for development setup and guidelines.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3 of the License.

See LICENSE for details.

Extension points exported contracts — how you extend this code

FileReader (Interface)

* File reader abstraction for reading files from either local fs or Runtime. [8 implementers]

src/node/utils/main/instructionFiles.ts

CreationHarness (Interface)

(no doc) [27 implementers]

tests/ui/chat/newChatStreamingFlash.test.ts

WorkspaceChatEventAggregator (Interface)

(no doc) [3 implementers]

src/browser/utils/messages/applyWorkspaceChatEventToAggregator.ts

UserPreferenceStorageArea (Interface)

(no doc) [3 implementers]

src/common/preferences/userPreferencesStorage.ts

StoryDef (Interface)

* Story definitions. `playInteraction` is a Playwright callback that replicates * the Storybook play function for stori

scripts/capture-readme-screenshots.ts

VscodeBridge (Interface)

(no doc) [1 implementers]

vscode/src/webview/vscodeBridge.ts

SharedConversationMetadata (Interface)

(no doc)

packages/chat-components/src/sharedConversation.ts

RFBOptions (Interface)

(no doc)

src/types/novnc.d.ts

Core symbols most depended-on inside this repo

resolve

called by 3545

src/node/services/onePasswordService.ts

push

called by 2222

src/browser/testUtils.ts

get

called by 1933

src/browser/utils/lruCache.ts

assert

called by 1659

src/common/utils/assert.ts

src/browser/utils/lruCache.ts

called by 751

src/common/types/result.ts

Err

called by 733

src/common/types/result.ts

Shape

Function 9,379

Method 3,546

Interface 2,100

Class 471

Enum 2

Route 1

Languages

TypeScript99%

Python1%

Modules by API surface

src/node/services/taskService.ts277 symbols

src/node/services/workspaceService.ts251 symbols

src/node/services/agentSession.ts173 symbols

src/browser/stores/WorkspaceStore.ts154 symbols

src/browser/utils/messages/StreamingMessageAggregator.ts147 symbols

src/node/services/workflows/WorkflowRunner.ts138 symbols

src/node/services/workspaceGoalService.ts134 symbols

src/node/services/streamManager.ts114 symbols

src/node/acp/agent.ts96 symbols

src/node/runtime/SSHRuntime.ts86 symbols

src/node/config.ts86 symbols

src/browser/utils/vim.ts85 symbols

Dependencies from manifests, versioned

@1password/sdk0.4.0 · 1×

@agentclientprotocol/sdk0.25.0 · 1×

@ai-sdk/amazon-bedrock4.0.101 · 1×

@ai-sdk/anthropic3.0.82 · 1×

@ai-sdk/deepseek2.0.33 · 1×

@ai-sdk/google3.0.68 · 1×

@ai-sdk/mcp1.0.40 · 1×

@ai-sdk/openai3.0.62 · 1×

@ai-sdk/openai-compatible2.0.46 · 1×

@ai-sdk/xai3.0.88 · 1×

@aws-sdk/credential-providers3.940.0 · 1×

@babel/core7.28.5 · 1×

For agents

$ claude mcp add mux \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact