MODMUX

Local gateway for coding agents

Local Copilot gateway for coding agents.

Modmux gives Claude Code, Cline, and Codex one stable localhost endpoint with compatible APIs, reversible config, and visible runtime controls.

See how it works Install Modmux
  • Runs on localhost only
  • Supports reversible agent configuration

$ modmux start

Authenticates with GitHub Copilot

$ modmux configure claude-code

Writes reversible local agent config

$ modmux status

Running on http://127.0.0.1:11435

Claude Code Cline Codex

Why use Modmux

Keep agent setup in one place.

Use one local gateway between supported coding agents and GitHub Copilot instead of maintaining separate per-tool config paths.

One shared local endpoint

Point supported agents at one stable localhost gateway instead of wiring each tool to a different provider-specific path.

Local and reversible

Modmux binds to 127.0.0.1. Supported config changes can be undone with modmux unconfigure.

Visible to operate

Start, stop, restart, inspect status, check health, and review usage without losing track of what is actually running.

How it works

The request path stays short and explainable.

A supported agent talks to Modmux on localhost. Modmux translates compatible request and response shapes, then forwards them through GitHub Copilot.

Supported agent

Claude Code, Cline, or Codex sends requests to one local endpoint.

Modmux

Exposes compatible endpoints, translates traffic, and keeps the runtime visible from the CLI.

  • /v1/messages
  • /v1/chat/completions
  • /v1/responses
  • /v1/models, /v1/usage, /health

GitHub Copilot

Modmux authenticates with GitHub and forwards requests through the Copilot-backed model path.

Trust boundary: Modmux is a local gateway, not a hosted relay or agent runtime. It keeps the network surface local and the configuration changes explicit.

Install

Install it, start it, point an agent at it.

The recommended path is still from source. If you do not want to install Deno, use a direct binary from GitHub Releases.

Recommended

From source

Clone the repository and install globally with the current Deno task.

git clone https://github.com/modmux/modmux.git cd modmux deno task install
  1. Run modmux start and complete GitHub auth.
  2. Run modmux configure claude-code.
  3. Confirm the endpoint with modmux status.

FAQ

Questions that usually block adoption.

Do I need a GitHub Copilot subscription?

Yes. Modmux routes requests through GitHub Copilot, so you need an active Copilot-backed account.

Does Modmux expose an API on my network?

No. The service binds to 127.0.0.1, so it stays local to your machine.

Can I undo a configuration change?

Yes. Supported agent configuration is reversible by design with modmux unconfigure.

Which agents are supported right now?

The built-in registry currently includes Claude Code, Cline, and Codex.

Do I need Deno to use Modmux?

Deno is only required for the recommended source install. Downloading a direct binary from GitHub Releases does not require it.