CLI Reference

All subcommands are also accessible from within the TUI. The CLI surface exists for scripts, muscle memory, and pipelines.

ccmux

ccmux [path]

Launch the TUI. Optional path scopes the session to that directory instead of projects.root.

ccmux new

ccmux new <name> [-d "description"]

Scaffold a new project under projects.root, run git init, open a tmux session, and start your AI agent with your description as the first prompt. The agent (Claude / Codex / Gemini) is picked in the TUI’s n form and persisted to <project>/.ccmux/agent; the CLI form defaults to Claude.

ccmux list

ccmux list

Print all running sessions (local + any discovered remote hosts) with their state.

ccmux attach

ccmux attach <name>

Attach to a named session. Uses ssh -t for remote sessions; mosh if the host was pinned with --mosh.

ccmux update

ccmux update [--dry-run] [--skip-pull] [--no-restart]

Pull the git checkout, rebuild, reinstall, and reload ccmuxd.

ccmux daemon

ccmux daemon install   # register ccmuxd under launchd / systemd
ccmux daemon start
ccmux daemon stop
ccmux daemon status

ccmux host add

ccmux host add <name> --addr <host:port> [--mosh]

Manually pin a host (for non-Tailscale hosts or to force a specific port). Auto-discovered Tailscale peers don’t need this.

ccmux moshi-setup

ccmux moshi-setup [--token <token>]

Install moshi-hook, run Easy Pair (QR code), wire Claude Code hooks. --token bypasses the QR flow for headless setups.

ccmux setup

Interactive wizard — checks all dependencies, offers to install missing ones.

ccmux doctor

ccmux doctor

Non-interactive health check. Include the output when filing bug reports.

ccmux uninstall

ccmux uninstall [--yes] [--dry-run] [--keep-config] [--keep-chrome]

Clean removal. Never touches project directories, notes, or ~/.claude/.

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