Tutorial 3: Working From Your Phone

Goal: your iPhone gets a push when Claude needs input; tap it, attach, answer.

Setup (one-time)

ccmux moshi-setup

This installs moshi-hook, then runs moshi-hook host setup. A QR code appears in your terminal. Open the Moshi iOS app, tap Add Host → Scan QR, point your phone at the terminal. Done.

The wizard also wires Claude Code’s hook entries so notifications fire automatically.

How it works

After pairing:

• The Moshi app lists every tmux session on your Mac
• When Claude pauses (needs_input), your phone vibrates with a categorized push: approval_required or task_complete
• Tap the notification → Moshi picker → attach → answer → swipe away

BEL fallback (non-Moshi)

Any iOS terminal client that maps terminal BEL to a local notification (Blink Shell, Termius) works without Moshi — you lose push categories, everything else works.

Suppress duplicate notifications

By default the laptop bell rings even when Moshi is paired (complementary, not duplicate). To mute the bell when Moshi is reporting:

# ~/.config/ccmux/config.toml
[notifications]
moshi_suppresses_bell = true

Headless / scripted setup

ccmux moshi-setup --token <token>

Bypasses the QR flow — useful for remote machines without a display.

Spotted an error or something out of date? Edit this page on GitHub.