Tutorial 6: Maintenance

Health check

The fastest way to check everything is the Settings screen — press 6 in the TUI. It shows daemon status, Moshi pairing state, and your current config without leaving ccmux.

For a detailed non-interactive report from the shell:

ccmux doctor checking every dependency, then the Settings screen showing runtime status

ccmux doctor

Non-interactive check of tmux, mosh, Tailscale, ripgrep, every AI agent, and Moshi pairing. Include the output when filing bug reports.

Update

When a new version is available, a banner appears at the top of the dashboard:

ccmux update

Pulls the git checkout, rebuilds, reinstalls ccmux + ccmuxd to ~/.local/bin/, and restarts the daemon with the new binary.

Flag	Effect
`--dry-run`	Show what would happen without doing it
`--skip-pull`	Build from the current checkout without `git pull`
`--no-restart`	Build and install but don’t reload the daemon

Uninstall

ccmux uninstall            # interactive — shows what it'll do, asks y/N
ccmux uninstall --yes      # skip the prompt
ccmux uninstall --dry-run  # preview only

What gets removed:

Running ccmuxd (SIGTERM)
~/.local/bin/ccmux and ~/.local/bin/ccmuxd
~/.local/state/ccmux/ (socket, logs)
~/.local/share/ccmux/ (snapshots, daemon db)
~/.config/ccmux/ (unless --keep-config)
The ccmux-styled tmux status bar on every c-* session (unless --keep-chrome)

Never touched: your project directories, your notes, ~/.claude/.

To also remove moshi-hook:

brew services stop moshi-hook && brew uninstall moshi-hook && brew untap rjyo/moshi

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