Skip to main content
CODEMUXManual

Codemux Documentation

Complete documentation for Codemux, the agent development environment for native chat, terminals, workspaces, and browser automation.

Codemux is an agent development environment (ADE) built with Tauri, React, and Rust. It gives you native multi-provider chat, workspaces with real terminal panes, an embedded browser, git integration, and orchestration — all in one window.

Quick Start

  1. Install Codemux from a release package or source
  2. Launch, open a project (or pick a recent one) from the Home screen, and write your first prompt in the chat draft
  3. Send to create the workspace, or open a terminal with Ctrl+T and split it with Ctrl+Shift+D

Documentation

Core

Workspace & Layout

  • Workspaces — Creating, managing, and organizing workspaces
  • Devices Page — Your other machines and the work on them: pull, open in place, or sweep settled worktrees
  • Web Remote Access — Drive a desktop or headless Codemux instance from another browser, over your network or from anywhere
  • Projects — Open, create, clone, and manage projects
  • Terminal — Terminal panes, tabs, splits, and configuration
  • Browser — Embedded browser pane with agent automation
  • Command Palette — Quick actions via Ctrl+K

Git & Code Review

  • Changes — Stage, commit, push, pull from the Changes panel
  • Diff Viewer — Split/unified diff views with conflict highlighting
  • Pull Requests — Create PRs and read their checks and review comments
  • Reviewing & Merging — Line notes, verdicts, review threads, and merging in place
  • The Pull Requests Page — Triage every request across the repos you have open

Features

Agent Chat

The default native conversational surface for Claude, Codex, Cursor, Grok, OpenCode, (experimentally) Hermes, and custom ACP agents. The classic terminal-first interface remains available under Settings → Interface.

  • Agent Chat — Streaming chat, mode pills, plan proposals, multi-provider picker
  • Workflow Orchestration — Dynamic cross-provider workflows and Claude Workflow runs
  • Attachments — Attach files, folders, GitHub issues, GitHub PRs, and images
  • Skills Sync — Server-side cross-device skill sync
  • MCP Servers — Host user-installed MCP servers in chat sessions

Reference

  • Browser Agent Commands — CLI and socket API for browser automation
  • CLI — Control a running Codemux instance from the terminal
  • MCP Server — Let outside assistants control workspaces, the browser, and native chat threads