CodeMux

One workbench for Claude Code, Copilot CLI, OpenCode and Codex — on your desktop, in any browser, or from your chat app.

English | 简体中文 | 日本語 | 한국어 | Русский

Website · Download · Docs · Roadmap

CodeMux is an open-source desktop and web client for coding agents. It does not wrap a model API. It talks to each agent's own runtime at the protocol level, so Claude Code, GitHub Copilot CLI, OpenCode and Codex keep their tools, sessions and project context, and you get one interface on top of all of them.

Then it lets you leave your desk. The same sessions, with every tool call, diff and shell command rendered live, are reachable from your phone's browser or from Feishu, DingTalk, Telegram, WeCom, Teams or WeChat, with no port forwarding.

• 🔀 Multi-engine, not multi-model: four real agent runtimes behind one UI, switchable per session.
• 👀 See the whole chain of thought: every tool call, file diff and command is an expandable step, not a wall of text.
• 📱 Remote by default: LAN QR code or one-click Cloudflare Tunnel, with device approval and per-device tokens.
• 💬 Agents in your chat app: streaming, structured replies in six IM platforms.
• 🧰 A real workbench: integrated terminal, file explorer, git worktrees, scheduled tasks, slash commands and skills.

💡 CodeMux is the first open-source GUI for GitHub Copilot CLI, connecting over JSON-RPC to deliver Copilot's full agentic experience visually.

⚠️ The macOS build is not code-signed. If macOS says "App is damaged", run xattr -cr /Applications/CodeMux.app.

CodeMux detects installed engines on startup. You need at least one:

1. Open Remote connections in CodeMux. Under Access this computer from another device, choose Direct connection for LAN access or Cloudflare Tunnel to reach it from anywhere (quick tunnels need no account).
2. For Direct connection, enter this computer's LAN address (for example http://192.168.1.20:8233) and select Enable direct access. For Cloudflare Tunnel, enable the tunnel. Scan the QR code shown on the page.
3. Enter the host's 6-digit access code on your phone, then approve the new device on the host.

Every agent action is an expandable step: file diffs with syntax highlighting, shell commands with live output, searches, tool calls, todo lists and permission prompts. You see what the agent is doing and why, not only the final answer, and the same rendering follows you to the browser and to IM.

Integrated terminal	Git changes with inline diff
Scheduled tasks	File explorer and preview

New devices must be approved with a 6-digit code, each device gets its own JWT, and public tunnels use HTTPS. You can rename or revoke any device from the Devices page.

Remote access	Device management	Same session on a phone

CodeMux is designed for personal use. Revoke devices you no longer use and turn the public tunnel off when you do not need it.

Talk to your agents from IM with streaming output and structured cards, not just plain text replies. Start in a private chat with the bot, pick a project and session, and use /cancel, /status, /mode, /model, /history and /help.

📖 Channel setup guide

flowchart TB
  subgraph Access
    A[Desktop app<br/>Electron]
    B[Browser / PWA<br/>LAN · Cloudflare Tunnel]
    C[IM bots<br/>Feishu · DingTalk · Telegram<br/>WeCom · Teams · WeChat]
  end
  A & B & C -->|WebSocket JSON-RPC| G[Gateway server<br/>engine manager]
  G --> O[OpenCode adapter<br/>HTTP + SSE]
  G --> P[Copilot adapter<br/>stdio]
  G --> Q[Claude Code adapter<br/>Agent SDK]
  G --> R[Codex adapter<br/>stdio]

All clients connect through the same gateway, and every engine is translated into one normalized type system, so tool calls, diffs and streaming messages look the same whichever engine or client you use.

Issues, ideas and pull requests are welcome. Start with CONTRIBUTING.md, check the Roadmap, and ask anything in Discussions. Want another engine? See Adding a new engine.

If CodeMux is useful to you, a ⭐ helps other people find it.

MIT