Tutorial 6: Maintenance

Health check

ccmux doctor

Non-interactive check of every dependency and daemon state. Include the output when filing bug reports.

Update

ccmux update

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

Flags:

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, notes under <project>/docs/, ~/.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.