<div align="center">

CodeMux

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

Multi-Engine AI Coding Client with Full Remote Agent Experience.

<img src="https://raw.githubusercontent.com/realDuang/codemux/main/assets/logo.png" alt="CodeMux" width="120" />

A multi-engine AI coding client with full agent chain-of-thought visualization and zero-config secure remote access — not another chat wrapper.

<img src="https://raw.githubusercontent.com/realDuang/codemux/main/assets/screenshots/main-chat.jpg" alt="CodeMux - Multi-Engine AI Coding Interface" width="800" /> </div>

---

Why CodeMux?

1. Multi-Engine, Not Multi-Model

This is not a chat wrapper that swaps API keys. CodeMux is a protocol-level gateway — each engine runs with its own runtime, sessions, tool execution, and capabilities fully preserved.

Switch between engines from a single interface. Each keeps its full power — file editing, shell access, session history, project context — CodeMux just gives them a shared front door.

| Engine | Protocol | Status | |--------|----------|--------| | OpenCode | HTTP REST + SSE | ✅ Stable | | GitHub Copilot CLI | JSON-RPC/stdio | ✅ Stable | | Claude Code | SDK (stdio) | ✅ Stable |

💡 CodeMux is also the first — and currently only — open-source GUI for GitHub Copilot CLI, connecting at the protocol level (JSON-RPC over stdio) to deliver Copilot's complete agentic coding experience in a visual interface.

2. Agent Chain-of-Thought Visualization

Every agent action is rendered as an expandable step — file diffs, shell commands, search results, tool calls — so you can see exactly what the agent is doing and why, not just the final answer.

<img src="https://raw.githubusercontent.com/realDuang/codemux/main/assets/screenshots/chat-steps.jpg" alt="CodeMux - Step-by-Step Agent Visualization" width="700" />

This isn't limited to the desktop app. The full chain-of-thought experience is preserved across every access method — whether you're on a browser via LAN or public internet, or interacting through an IM bot on your phone.

3. True Remote Agent Experience

Tools like OpenClaw have popularized the idea of accessing AI from messaging apps — send a message on WhatsApp or Telegram, get a text reply. But for AI-assisted coding, a text reply isn't enough. You need to see what the agent is thinking, what files it's editing, what commands it's running — in real time.

CodeMux bridges this gap. Whether you access from a browser or an IM platform, you get the complete agent experience with structured streaming:

| Capability | CodeMux | Text-based assistants | |------------|---------|----------------------| | Streaming output | ✅ Token-level real-time streaming | ⚠️ Complete reply or chunked text | | Thinking steps | ✅ Each tool call rendered as expandable step | ❌ Final answer only | | File diffs | ✅ Inline diff viewer with syntax highlighting | ❌ Plain text or none | | Shell commands | ✅ Command + output rendered in real time | ❌ Text summary at best | | Multi-engine | ✅ Switch between OpenCode / Copilot / Claude Code | ❌ Single model / provider | | Coding context | ✅ Project-aware sessions with full tool access | ⚠️ Generic assistant context | | Image input | ✅ Paste/drag images for all engines to analyze | ❌ Text-only input |

4. Multimodal Support

Text-based coding tools are limited to text input. CodeMux breaks this barrier — attach images to your prompts and let the AI see what you see.

Paste a screenshot, drag in a design mockup, or upload an error image — all three engines can analyze images natively. Each engine adapter translates images into its native format behind the scenes, while you get a unified experience:

• Upload methods: File picker, drag & drop, clipboard paste
• Supported formats: JPEG, PNG, GIF, WebP (up to 4 images per message, 3MB each)
• Inline preview: Thumbnails shown before sending, images rendered in chat history

This works across all access methods — desktop, remote browser, and IM bots — wherever CodeMux runs, image input follows.

5. Developer Workflow Tools

CodeMux goes beyond chat — it provides integrated tools to manage your development workflow directly from the interface.

• Scheduled Tasks: Automate recurring agent tasks — run code reviews every morning, generate reports on an interval, or batch-process issues weekly. Supports manual trigger, interval (5 min – 12 hours), daily, and weekly scheduling with missed-run catch-up when the app restarts.

• Git Worktree Parallel Sessions: Work on multiple branches simultaneously without git stash. Create isolated worktrees from the sidebar, each with its own directory, branch, and AI sessions. Merge back with your choice of merge, squash, or rebase — all without leaving the UI.

• File Explorer & Git Monitoring: Browse project files with a collapsible tree, preview code with syntax highlighting, and track git changes in real time. A "Changes" tab shows modified files with line-level add/remove counts, and an inline diff viewer lets you inspect every change without leaving CodeMux.

• Slash Commands & Engine Skills: Type / in the input to invoke engine-native commands and skills with autocomplete — /cancel, /status, /mode, /model, and more. Each engine exposes its own commands; Copilot surfaces project-level and personal skills, Claude Code surfaces user-installed skills, and OpenCode passes through its SDK commands — all through a unified autocomplete UI.

And More

• Agent mode switching: Toggle between Build / Plan / Autopilot modes per engine — each with its own behavior and prompt style
• Live todo panel: Agent-generated task lists displayed above the input area with real-time progress tracking
• Permission approvals: Approve or deny sensitive operations (shell, file edits) inline — with "always allow" for trusted patterns
• Interactive questions: Engines can ask single/multi-select questions with descriptions and custom input
• Per-engine model selection: Pick different models for each engine independently; Copilot and Claude Code support custom model ID input
• Token usage tracking: Monitor input, output, and cache token consumption with per-engine cost breakdowns

Browser Remote Access

Access your coding agents from any device — phone, tablet, or another machine — without touching a single config file.

• LAN: Auto-detected IP + QR code, ready in seconds
• Public Internet: One-click Cloudflare Tunnel — no port forwarding, no VPN, no firewall changes. Supports both quick tunnels (random ephemeral URL, zero config) and named tunnels (persistent custom domain via ~/.cloudflared/ credentials)
• Security built-in: Device authorization, JWT tokens, HTTPS via Cloudflare; quick tunnel URLs rotate on every restart, named tunnels preserve your custom hostname

IM Bot Channels

Use your AI coding agents directly from your favorite messaging apps with real-time streaming and structured rich content — not just plain text replies.

Supported Platforms

| Platform | Event Receiving | Streaming | Group Creation | Rich Content | |----------|----------------|-----------|----------------|--------------| | Feishu (Lark) | WebSocket (长连接) | ✅ Edit-in-place | ✅ Auto-create group | Interactive Cards | | DingTalk | Stream mode (WS) | ✅ AI Card | ✅ Scene groups | ActionCard / Markdown | | Telegram | Webhook / Long Polling | ✅ sendMessageDraft | ❌ P2P only | MarkdownV2 + InlineKeyboard | | WeCom | HTTP Callback (AES XML) | ❌ Batch mode | ✅ App group chat | Markdown / Template Card | | Microsoft Teams | Bot Framework HTTP | ✅ Edit-in-place | ❌ P2P only | Adaptive Cards v1.5 |

Common Features

• P2P entry point: Private chat with the bot to select projects and sessions
• Slash commands: /cancel, /status, /mode, /model, /history, /help
• Streaming responses: Real-time AI output with platform-appropriate update strategy
• Tool summary: Completion messages include action counts (e.g. Shell(2), Edit(1))
• Auto-approve permissions: Engine permission requests are approved automatically

Session Models

• One Group = One Session (Feishu, DingTalk, WeCom): Each group chat maps to a single CodeMux session. Start in P2P → select project → group auto-created.
• P2P Direct (Telegram, Teams): Interact directly in private chat with temporary sessions (2h TTL). In group chats, @mention the bot to interact.

Setup

Each platform requires creating a bot/app on its developer portal and configuring credentials in CodeMux Settings → Channels.

📖 Detailed setup guide → — Step-by-step instructions for each platform, including permissions, webhook configuration, and troubleshooting.

| Platform | Required Credentials | Developer Portal | |----------|---------------------|-----------------| | Feishu | App ID, App Secret | open.feishu.cn | | DingTalk | App Key, App Secret, Robot Code | open.dingtalk.com | | Telegram | Bot Token (from @BotFather) | core.telegram.org | | WeCom | Corp ID, Corp Secret, Agent ID, Callback Token, Encoding AES Key | [developer.work.weixin.qq.com](https://developer.wo