Muxagent

MuxAgent

Your AI coding agents, remote-controlled from your phone.

Claude Code, Codex, Gemini CLI, GitHub Copilot, OpenCode, and Goose run on
your dev machine — MuxAgent lets you drive them from anywhere. Pair the
mobile app to a daemon on your Mac, Linux, or Windows box and monitor,
prompt, and approve sessions from your pocket.

Installation

macOS / Linux

The install script puts muxagent in /usr/local/bin when writable,
otherwise it falls back to ~/.local/bin.

Windows

Download the latest muxagent-windows-*.zip bundle from
GitHub Releases, unzip it, and
run muxagent.exe.

Official installs include everything needed to run MuxAgent with Claude Code.

Quick Start

You can be driving a Claude Code session from your phone in under a minute.

1. Install the MuxAgent mobile app.
   Google Play | App Store
2. On your dev machine, start the daemon:

3. Scan the QR code in the app to pair. First run walks through setup, then
   starts the daemon.

Once paired, pick any supported runtime — Claude Code, Codex, Gemini CLI,
GitHub Copilot, OpenCode, or Goose — and you are attached to a live session.

Pairing keys and session traffic are described in
SECURITY.md.

CLI Commands

Everything the mobile flow needs lives under a handful of commands:

Daemon

- muxagent daemon start — First-time setup, or start the daemon in the background.
- muxagent daemon status — Check whether the daemon is running.
- muxagent daemon stop — Stop the daemon.
- muxagent daemon attach-session  --runtime  — Attach an existing local runtime session (e.g. --runtime claude-code) so the mobile app can continue it.

Auth / pairing

- muxagent auth login — Pair a mobile device via QR code.
- muxagent auth status — Show current pairing status.
- muxagent auth logout — Remove stored…