coder

coder/xum

A desktop app for isolated, parallel agentic development

View on GitHub Website / Demo Back to listing

2.1kstars 142forks 23contributors TypeScript

README.md

# Xum - Coding Agent Multiplexer

[![Download](https://img.shields.io/badge/Download-Releases-purple)](https://github.com/coder/mux/releases)
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL%203.0-blue.svg)](LICENSE)
[![Discord](https://img.shields.io/discord/1446553342699507907?logo=discord&label=Discord)](https://cdr.co/mux-discord)
[![X (formerly Twitter)](https://img.shields.io/badge/Follow-%40codermux-black?logo=x)](https://x.com/codermux)

</div>

> [!IMPORTANT]
> This project was renamed from Mux to Xum after Mux.com raised a trademark concern. “Mux” is a common technical abbreviation of “multiplexer” and we do not expect confusion between the projects, but chose to rename ours rather than spend more time on the dispute.

## Features

- **Isolated workspaces** with central view on git divergence ([docs](https://mux.coder.com/runtime))
  - **[Local](https://mux.coder.com/runtime/local)**: run directly in your project directory
  - **[Worktree](https://mux.coder.com/runtime/worktree)**: git worktrees on your local machine
  - **[SSH](https://mux.coder.com/runtime/ssh)**: remote execution on a server over SSH
- **Multi-model** (`sonnet-4-*`, `grok-*`, `gpt-5-*`, `opus-4-*`)
  - Ollama supported for local LLMs ([docs](https://mux.coder.com/config/models#ollama-local))
  - OpenRouter supported for long-tail of LLMs ([docs](https://mux.coder.com/config/models#openrouter-cloud))
- **VS Code Extension**: Jump into Xum workspaces directly from VS Code ([docs](https://mux.coder.com/integrations/vscode-extension))
- Supporting UI and keybinds for efficiently managing a suite of agents
- Rich markdown outputs (mermaid diagrams, LaTeX, etc.)

Xum 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](https://mux.coder.com/workspaces/compaction) and [mode prompts](https://mux.coder.com/agents/instruction-files#mode-prompts).

**[Read the full documentation →](https://mux.coder.com)**

## Install

Download pre-built binaries from [the releases page](https://github.com/coder/mux/releases) for
macOS and Linux.

[More on installation →](https://mux.coder.com/install)

## Screenshots

<table>
<tr>
<td align="center" width="50%">
<img src="./docs/img/code-review.webp" alt="Screenshot of code review" width="100%" /> 
Integrated code-review for faster iteration
</td>
<td align="center" width="50%">
<img src="./docs/img/agent-status.webp" alt="Screenshot of agent status" width="100%" /> 
Agents report their status through the sidebar
</td>
</tr>
<tr>
<td align="center" width="50%">
<img src="./docs/img/git-status.webp" alt="Screenshot of git status" width="100%" /> 
Git divergence UI keeps you looped in on changes and potential conflicts
</td>
<td align="center" width="50%">
<img src="./docs/img/plan-mermaid.webp" alt="Screenshot of mermaid diagram" width="100%" /> 
Mermaid diagrams make it easier to review complex proposals from the Agent
</td>
</tr>
<tr>
<td align="center" colspan="2">
<img src="./docs/img/costs-tab.webp" alt="Screenshot of costs table" width="50%" /> 
Stay looped in on costs and token consumption
</td>
</tr>
<tr>
<td align="center" colspan="2">
<img src="./docs/img/context-management.webp" alt="Screenshot of context management dialog" width="50%" /> 
Context management dialog keeps compaction controls in one place
</td>
</tr>
<tr>
<td align="center" colspan="2">
<img src="./docs/img/mobile-server-mode.webp" alt="Screenshot of Xum mobile UI" width="40%" /> 
Xum server mode has a responsive UI for mobile users
</td>
</tr>
</table>

## More reading

See [the documentation](https://mux.coder.com) for more details.

## Development

See [AGENTS.md](./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](./LICENSE) for details.

Repository info

Default branch: main
Latest version: v0.32.2
Created: 17/09/2025
Last activity: 14/11/2026
License: AGPL-3.0
Open issues: 474
Watchers: 9

Topics

agent ide

Contributors

ThomasK33

3k contributions

ammar-agent

1.4k contributions

ibetitsmike

769 contributions

ethanndickson

388 contributions

ammario

386 contributions