v0.1.7 · macOS + Linux + iOS + Android

Your terminal,
in your pocket.

Monitor and interact with terminal sessions on your Mac or Linux machine from your iPhone or Android — in real time. No tmux required.

brew brew install Highwall2016/tap/ccmux
App Store Google Play
9:41
build-server · zsh CPU 4% MEM 1.2G
→ cargo build --release
Compiling myapp v2.1.0
Compiling tokio v1.35.0
Compiling serde v1.0.195
Compiling axum v0.7.4
Building [=====> ] 52/94
 
→ ./run-tests.sh
✓ auth::login_test
✓ auth::token_refresh
✓ api::health_check
✓ db::connection_pool
running 18 tests …
▌
Tab
Esc
Ctrl
↑
↓
^C
16ms
PTY output latency
0
Dependencies required
∞
Scrollback buffer
2
Platforms: iOS + Android
Getting started

Up in three steps

Install the agent on your machine, authenticate once, then open the app and start controlling your terminal from anywhere.

01

Install the agent

One command on your Mac or Linux machine. The agent runs as a background daemon and manages your PTY sessions.

brew install Highwall2016/tap/ccmux
02

Authenticate

Run ccmux auth login to open your browser, sign in with Google, and auto-register your device. One-time setup.

ccmux auth login
03

Open the app

Install ccmux on your iPhone or Android. Your machine appears instantly. Tap any session to start typing.

App Store · Google Play
Capabilities

Everything your terminal needs,
minus the desk

ccmux is not a thin SSH wrapper. It's a purpose-built terminal multiplexer with a native mobile experience.

🖥️

Full interactive PTY

Real pseudo-terminal on every session. Keyboard toolbar with Tab, Esc, arrow keys, Ctrl+C, PgUp/PgDn. Sticky Ctrl/Alt modifiers for key combinations. Scrollback replay when you open a session.

16ms PTY batching
🔔

Push notifications

Get alerted on your phone when your terminal outputs error, failed, panic, or fatal patterns. Set up alerts for any pattern that matters to your workflow.

Firebase FCM
📂

Session management

Create named sessions or auto-assigned ones. Group sessions by Active and Ended. Kill, rename, and switch between sessions without leaving the app. Device switcher to control multiple machines.

Multi-device
⚡

Zero-latency streaming

PTY output batched in 16ms windows and forwarded over WebSocket through an in-memory hub. No database on the critical path. Output reaches your phone as fast as your network allows.

WebSocket + MessagePack
🔀

tmux integration

Optional tmux support auto-discovers all your panes and registers them as ccmux sessions. The app shows the full tmux session → window → pane hierarchy. Ctrl+B shortcuts built in.

tmux-optional
📊

Live system metrics

CPU and memory usage shown live in the navigation bar while you're in a session. Know when your machine is thrashing before you SSH in to check.

gopsutil
Use cases

Stay in the loop, wherever you are

Walk away from your desk without walking away from your work.

Build monitoring

Watch long builds without babysitting them

Start a release build, step away. Glance at your phone to check progress — or get a push notification when it fails.

deploy · zsh
$ make release
→ Building linux/amd64…
→ Building linux/arm64…
→ Building darwin/arm64…
✓ build complete
→ Pushing to registry…
⚠ slow upload (12 MB/s)
→ Tagging v2.4.1…
✓ pushed ghcr.io/org/app:2.4.1
Error alerts

Get paged when something goes wrong

ccmux watches your terminal output for error patterns and sends a push notification to your phone — no PagerDuty required.

server · logs
INFO handler: GET /api/users 200
INFO handler: POST /api/login 200
INFO handler: GET /api/posts 200
PANIC runtime error: nil pointer
goroutine 47 [running]
main.(*Handler).Serve+0x3a
🚨
ccmux · server · logs
PANIC runtime error: nil pointer dereference in goroutine 47
Remote control

Run quick commands without SSH apps

Type directly into your terminal from your phone. Full keyboard with mobile-friendly toolbar. No SSH client setup needed.

home-server · bash
→ systemctl status nginx
● nginx.service - A high performance web server
Loaded: loaded (/lib/systemd/system/nginx.service)
Active: active (running) since Mon 2026-05-06
→ df -h | grep /dev/sda
/dev/sda1 892G 710G 71% /
CI/CD monitoring

Track deploys while you're in a meeting

Keep an eye on staging deploys, database migrations, and test runs from your pocket. No laptop required.

deploy-prod · sh
$ ./scripts/deploy-prod.sh v2.4.1
✓ health check passed
✓ DB migrations: 3 applied
✓ containers rolled over: 4/4
✓ smoke tests: 12/12 passed
→ deploy complete in 2m 14s
tmux integration

Works with tmux.
Doesn't need it.

ccmux auto-discovers all your tmux sessions, windows, and panes when the agent starts. The mobile app shows the full hierarchy so you can navigate your workspace exactly as you left it.

But if you don't use tmux, that's fine too. ccmux creates and manages its own sessions independently.

  • Session → Window → Pane hierarchy shown in the drawer
  • Window tab bar with swipe-to-switch gesture
  • Ctrl+B shortcuts built into the toolbar
  • Create windows and split panes directly from the app
  • Full tmux keybinding support via sticky modifiers
0:build
1:server
2:logs
3:db
pane 0 · vim
fn main() {
let cfg = Config::load();
server::run(cfg).await;
}
pane 1 · zsh
→ cargo test
✓ 47 tests passed
✓ 0 failures
pane 2 · server logs
INFO listening on 0.0.0.0:8080
INFO GET /api/health 200 in 0.4ms
INFO POST /api/users 201 in 12ms
Installation

Get running in 60 seconds

Choose your platform. The agent and CLI are a single binary — no dependencies, no Docker required for the agent.

macOS (Homebrew) 
$ brew tap Highwall2016/tap
$ brew install ccmux
$ ccmux auth login
# Opens browser, signs in with Google, registers your device

# Optional: start automatically on login
$ brew services start ccmux

Requires macOS 12+. The agent connects to the ccmux cloud and your phone's app. Credentials stored in ~/.config/ccmux/.

macOS + Linux (curl) 
$ curl -fsSL https://ccmux.highwall-lab.us.ci/install | sh
# Installs ccmux and ccmux-agent to /usr/local/bin
# Detects OS + architecture automatically

$ ccmux auth login

Works on macOS and Linux (x86_64 + arm64). The installer uses sudo only to copy binaries to /usr/local/bin. On macOS, Gatekeeper quarantine is stripped automatically. View source on GitHub →

Windows (PowerShell) 
PS> iwr -useb https://ccmux.highwall-lab.us.ci/install.ps1 | iex
# Requires PowerShell 5.1+ / Windows 10+

PS> ccmux auth login

WSL (Windows Subsystem for Linux) is also supported — use the curl installer inside WSL. Native Windows requires PowerShell.

Download the ccmux app on your iPhone or Android. Sign in with the same Google account you used on your machine. Your devices appear automatically.

🍎
Download on the
App Store
🤖
Get it on
Google Play

Requires iOS 15+ or Android 8+. The app is free. An account is required for device pairing.