↓ Skip to main content
9 – 17 UHR +49 8031 3508270 LUITPOLDSTR. 9, 83022 ROSENHEIM
DE / EN
Orchestrator Manaflow, Inc. USA macOS app, terminal (TUI), SSH, cloud VMs

cmux

cmux by Manaflow: native macOS terminal app for coding agents like Claude Code and Codex, with vertical tabs, notifications, a browser and a socket API.

Licence GPL-3.0-or-later (app, CLI, TUI), BUSL-1.1 (server)
First release January 2026
Interfaces macOS app (Swift/AppKit), CLI and socket API (cmux), SSH and remote tmux, cmux TUI, iOS app (beta), Cloud VMs (paid plans)
Platforms macOS, Linux (cmux TUI), Windows (cmux TUI)

The seven building blocks in cmux

How cmux implements the building blocks of an AI harness

  1. 1

    Agent loop

    cmux does not run an agent loop of its own; it starts the agent CLIs as ordinary processes in Ghostty terminals. For Claude Code and Codex, cmux enables an integration by default that wraps the command and injects hooks.

  2. 2

    Tools and execution environment

    Tools come from the respective coding agent; cmux adds the `cmux` CLI with a socket API, a scriptable browser, skills and, once enabled, computer use as an MCP server for Claude Code and Codex.

  3. 3

    Context management

    The sidebar shows Git branch, PR status, working directory, listening ports and the latest notification for each workspace; through the CLI, agents can read the screen contents of other panes. cmux does not create Git worktrees itself.

  4. 4

    State and memory

    On quit, cmux saves windows, workspaces, splits, working directories and scrollback locally; according to the README, supported agents resume their session from the saved session ID. Running processes survive a restart only with `cmux local-tmux`.

  5. 5

    Permissions

    cmux makes no approval decisions; it notifies you when an agent is waiting for approval. cmux does not document bypass defaults of its own for local agents; the worktree example in the docs starts Codex with `--yolo` and Claude Code with `--dangerously-skip-permissions`.

  6. 6

    Verification and feedback

    Verification stays with the agent and the human; cmux supports it with notifications, PR status in the sidebar and a built-in browser in which agents can check their own web interface.

  7. 7

    Orchestration

    cmux's core contribution: many agents in workspaces and splits, controllable via CLI and socket API, Claude Code Teams as native splits, plus agents over SSH, remote tmux or on paid cloud VMs.

Models and model access

Which models the harness uses and how they are obtained

Models and model access
Models Model-agnostic: cmux starts the agents; the models are configured there
Access routes Model-agnostic (depends on the coding agent started), Optional via CodeRouter: ChatGPT, Claude and OpenCode Go subscriptions, API keys from OpenAI, OpenRouter and Anthropic, Amazon Bedrock
Free choice of model Yes
Custom endpoint / LLM gateway No
The cmux app does not call language models itself for agent work; the coding agent that is started determines model, provider and endpoint. The optional hosted service CodeRouter forwards requests from Claude Code, Codex, OpenCode and Pi to the team's subscriptions or API keys; provider traffic then comes from CodeRouter.
Features
MCP servers Sub-agents Hooks Skills Headless / CI SDK Resume sessions
Agents supported by herdr

Enterprise use

Data processing, controls and pricing model according to the vendor

Data processing and location

The macOS app works locally: session snapshots are stored under `~/Library/Application Support/cmux/`, hook mappings under `~/.cmuxterm/`. Cloud VMs, CodeRouter and iOS pairing run through Manaflow's cloud. According to the privacy policy, Manaflow processes this data in the US and other countries; the subprocessor list names mostly US providers and refers to a Data Processing Addendum.

Permissions

cmux makes no approval decisions. By default, cmux wraps the Claude Code and Codex commands to inject hooks; this can be switched off in the settings. By default, the socket API only accepts processes from cmux terminals, and computer use is opt-in. Cloud VMs are microVMs with passwordless root and full internet access by default; according to the docs, there are no egress logs yet.

Telemetry

According to the settings reference in the repository, anonymous telemetry is on by default and goes to PostHog and Sentry, plus a remote feature-flag fetch. It can be switched off in the settings or via the MDM policy `DisableTelemetry`; Sparkle also checks for updates.

Admin control

For managed Macs, cmux documents MDM policies delivered via configuration profile, such as `DisableCloud`, `DisableRemoteControl`, `DisableAICredentialUpload` or a browser allowlist. The pricing page lists SSO, SAML, audit logs, SOC 2 and an SLA only for the Enterprise plan.

License and pricing

The app, the CLI and the cmux TUI are licensed under GPL-3.0-or-later, the server components under BUSL-1.1; production use and self-hosting of the latter require a commercial license from Manaflow. Local use of cmux is free. Pro costs USD 50 and Max USD 200 per month, Team USD 60 per user and month, Enterprise is available on request (pricing page, as of 22 November 2026).

Strengths
  • Native macOS app in Swift and AppKit based on libghostty, picks up an existing Ghostty configuration
  • Sidebar with Git branch, PR status, ports and latest notification per workspace, notification rings as soon as an agent is waiting
  • Fully programmable via CLI and Unix socket, including a scriptable browser pane
  • Claude Code Teams and subagents as native splits instead of hidden background processes
  • Session restore with agent resume and full-text search across past agent sessions (Vault)
  • MDM policies for managed Macs, for example to switch off cloud, telemetry and remote access
Limitations
  • No built-in worktree management: you handle the isolation of parallel agents through custom commands or the agent itself
  • The native app is macOS only; Linux and Windows only via the separate cmux TUI
  • Anonymous telemetry on by default
  • Cloud VMs, CodeRouter and iOS pairing run through Manaflow's cloud with subprocessors mostly in the US
  • Server components under BUSL-1.1: self-hosting only with a commercial license
  • Remote tmux, the iOS app and cloud VMs are in beta or early access

Use cases

Typical tasks for this harness

Monitor several coding agents in splits and workspaces and step in when they ask for input
Run agents on remote machines via SSH or remote tmux and control them from the Mac
Let agents check their own web interface in the built-in browser
Script your own workflows with cmux.json, the CLI and the socket API, for example a worktree with two agents in one click
Run Claude Code Teams visibly as splits

cmux is a native macOS terminal app by Manaflow, Inc. that brings several AI coding agents such as Claude Code, Codex or OpenCode together in workspaces and splits. Vertical tabs, notifications when an agent needs input, a scriptable browser and a CLI with socket API make parallel agent work visible and controllable; cmux does not manage Git worktrees itself. As of 22 November 2026.

What is cmux?

cmux is an open-source terminal for macOS whose repository Manaflow, Inc. from California started in January 2026. The app is written in Swift and AppKit, renders via libghostty and picks up themes, fonts and colors from an existing Ghostty configuration; according to the README, cmux is not a fork of Ghostty. The current version is 0.65.2.2 from 27 October 2026 according to the changelog, and the manaflow-ai/cmux repository has 28,871 GitHub stars (GitHub API, 22 November 2026). cmux is installed as a DMG or via Homebrew cask, and updates arrive through Sparkle. The app runs on macOS 14 and later; Manaflow keeps a waitlist for further platforms. On Linux and Windows, the separate cmux TUI, a terminal multiplexer written in Rust, is already available. An iOS app for viewing and controlling the terminals is available in beta via TestFlight.

cmux as an AI harness

As an AI harness, cmux covers the orchestration building block: it provides the workspace for parallel agents without replacing their agent loop. According to its README, cmux sees itself as “a primitive, not a solution”: terminal, browser, notifications, workspaces, splits and a CLI, while you shape the workflow yourself. For each workspace, the sidebar shows Git branch, linked pull request, working directory, listening ports and the latest notification. When an agent is waiting for you, its pane gets a blue ring; this is triggered by the terminal sequences OSC 9, 99 and 777, by cmux notify or by agent hooks.

Through the CLI and a Unix socket, you can create workspaces, open splits, send input, read screen contents and drive the built-in browser. cmux ssh opens a workspace on a remote machine, and remote tmux is in beta. cmux claude-teams launches Claude Code’s teammates as native splits. cmux does not manage Git worktrees itself: the documentation on custom commands shows an example command in cmux.json that creates a worktree and starts Codex and Claude Code side by side in it. For a fee, Manaflow also offers cloud VMs, persistent Linux machines in early access with Claude Code, Codex, OpenCode and Pi preinstalled.

Models and model access

cmux is model-agnostic: the app starts the agent CLIs in ordinary terminals, and the respective agent determines model, provider and login. An existing login, including a subscription, stays in effect; subscription use for local agents is not documented explicitly, and the pricing page speaks of agents “with your own keys”. In addition, Manaflow offers CodeRouter, an optional hosted model router. According to its docs, it pools ChatGPT, Claude Max or Pro and OpenCode Go subscriptions as well as API keys from OpenAI, OpenRouter, Anthropic and Amazon Bedrock, shares them within the team and switches to another account when a rate limit hits. The requests to the provider are then made by Manaflow’s hosted service. Whether a subscription may be shared within a team is governed by the respective provider’s terms. Whether model access runs through a central proxy such as innFactory’s AI Gateway instead depends on the configuration of the respective agent.

Company use: data protection and governance

Run locally, cmux processes terminal content on the Mac; companies should settle four points before a broad rollout. First, telemetry: according to the settings reference, anonymous usage data goes to PostHog and error reports to Sentry by default; both can be switched off in the settings. Second, the cloud components: cloud VMs, CodeRouter and iOS pairing run through Manaflow’s cloud. According to the privacy policy, Manaflow processes this data in the US and other countries, and cloud VMs have full internet access by default without egress logs. Third, the agent integrations: by default, cmux wraps the Claude Code and Codex commands to inject hooks, and the worktree example in the docs starts both agents with their bypass flags; you should not adopt such templates without review. Fourth, the license: the app, CLI and TUI are licensed under GPL-3.0-or-later, the server components under BUSL-1.1, whose self-hosting requires a commercial license.

For managed Macs, cmux documents MDM policies delivered via configuration profile. They let you centrally block cloud, telemetry, remote access from the iPhone, file transfer and the upload of AI credentials, among other things, and restrict the built-in browser to an allowlist. According to the pricing page, SSO, SAML and audit logs are only available in the Enterprise plan. Independently of this, source code and prompts of the launched agents go to their model providers and belong in your records of processing.

Which agents does cmux support?

cmux supports any agent that runs in a terminal. The README explicitly names Claude Code, Codex, OpenCode, Gemini CLI, Kiro, Aider, Goose, Amp, Cline and Cursor Agent. Agents are integrated more deeply via cmux hooks setup: according to the README, cmux supports notifications and session resume for Claude Code, Codex, Grok, OpenCode, Pi, Amp, Cursor CLI, Gemini, Rovo Dev, Copilot, CodeBuddy, Factory and Qoder. Dedicated integration pages exist for Claude Code Teams as well as oh-my-claudecode, oh-my-codex, oh-my-opencode and oh-my-pi, whose subagents appear as native splits. Computer use, the control of Mac apps, is only available to Claude Code and Codex; CodeRouter serves Claude Code, Codex, OpenCode and Pi.

How it fits: cmux, herdr, Orca and the AI Gateway

cmux is a terminal with orchestration features, not a guided flow from task to pull request. herdr relies on a cross-platform terminal runtime with state detection and a CLI through which agents control each other. Orca creates a worktree for every task and brings diff review and pull requests. cmux provides a native macOS interface with notifications, a browser and a socket API; you build worktrees and review flows yourself. You will find a detailed comparison in the article herdr vs. Orca. None of the orchestrators captures developers’ costs and agent time across teams and projects; the AI Gateway does that in proxy and companion mode. For business users outside development, CompanyGPT is the right harness; our AI harness overview gives an overview.

From developer harness to enterprise harness

Coding harnesses are tools for developers. Business users, cost control and governance need two more layers.

CompanyGPT – the harness for business users

CompanyGPT gives any language model tools via MCP servers, integrations and n8n, company knowledge via companyRAG, roles from Entra ID or Keycloak, and audit logs – operated in your own cloud tenant (Azure, AWS or Google Cloud) or sovereignly on STACKIT.

Discover CompanyGPT
AI Gateway – cost and governance for every agent

The AI Gateway bundles the model access of your tools and coding agents behind an OpenAI-compatible API: sign-in via Entra ID, Keycloak or Cognito, budgets and hard limits per team and user, cost attribution per project and repository via the Companion, and logging of every request.

View the AI Gateway

Frequently Asked Questions

What is cmux?

cmux is a native macOS terminal app by Manaflow, Inc., built in Swift and AppKit on top of libghostty. It brings several coding agents such as Claude Code, Codex or OpenCode together in workspaces and splits, sends a notification when an agent is waiting, and can be controlled via CLI, socket API and a scriptable browser. cmux does not manage Git worktrees itself.

Is cmux open source and free?

The macOS app, the CLI and the cmux TUI are licensed under GPL-3.0-or-later and are free. The server components are licensed under BUSL-1.1, and Manaflow requires a commercial license for production use and self-hosting. According to the pricing page, paid plans mainly add cloud VMs: Pro for USD 50 per month, Max for USD 200, Team for USD 60 per user and month, Enterprise on request (as of 22 November 2026).

Which coding agents does cmux support?

Any agent that runs in a terminal. According to the README, these include Claude Code, Codex, OpenCode, Gemini CLI, Kiro, Aider, Goose, Amp, Cline and Cursor Agent. `cmux hooks setup` installs hooks for notifications and session resume for Claude Code, Codex, OpenCode, Pi, Amp, Gemini, Copilot and Grok, among others. cmux launches Claude Code Teams as native splits, and computer use is only available for Claude Code and Codex.

Does cmux use my Claude or ChatGPT subscription?

Locally, indirectly yes: cmux starts the agent CLIs in ordinary terminals, and their existing login stays in effect. This is not documented explicitly; the pricing page speaks of your own keys. According to its docs, the optional CodeRouter service pools a team's ChatGPT and Claude subscriptions and API keys and routes requests through Manaflow's hosted infrastructure. Whether a subscription may be shared within a team is governed by the respective provider's terms.

Can cmux be used in a GDPR-compliant way?

That depends on the configuration. The local app processes terminal content on the Mac but sends anonymous telemetry to PostHog and Sentry by default; you can switch this off in the settings or via MDM. Cloud VMs, CodeRouter and iOS pairing run through Manaflow's cloud with subprocessors mostly in the US. The model providers of the launched agents need to be assessed separately and belong in your records of processing.

Does cmux work with innFactory's AI Gateway?

Yes, through the agents it launches. The cmux app makes no model calls of its own for agent work. Claude Code or Codex can be routed through the AI Gateway via configuration, and the gateway's companion measures tokens and agent time from the local session logs, including subscription usage. CodeRouter is an alternative endpoint to this; for agents on cmux cloud VMs, the session logs are stored on the VM, not on the Mac.

Introduce coding agents safely in your company

We support selection, model access in the EU, permission design and cost control.