// readme

cmux Pocket

cmux Pocket is an independent Android companion for cmux on Mac, for developers who want remote access to their terminal workspaces and AI agent sessions from a phone.

Disclaimer: Independent community project. Not affiliated with or endorsed by cmux. “cmux” identifies the compatibility target only.

Download Signed APK · Highlights · Quick Start · Documentation

Highlights

Quick Start

You need Android 8.0+ and a Mac with macOS 13+ running cmux. Keep the Mac awake while connected.

  1. Install Android: download and install the latest signed APK from GitHub Releases.

  2. Start the Mac Gateway:

    brew install shiquda/cmux-pocket/cmux-pocket
    cmux-pocket setup
    cmux-pocket status
    
  3. Connect the devices: for the recommended Tailscale route, install Tailscale on both devices, connect them to the same tailnet, and enable MagicDNS and HTTPS certificates. With the tailscale CLI available on the Mac, run:

    cmux-pocket…