Skip to content
hivemuxdocs

Uninstall hivemux from your Mac

Run hivemux uninstall to remove hivemux. It deletes the hivemux blocks from ~/.tmux.conf, the Ghostty config and ~/.zshrc, removes the hivemux hooks from Claude Code settings, and closes the sidebars. Your own config stays; saved layouts and backups stay in ~/.local/share/hivemux.

Remove the configuration

Section titled “Remove the configuration”
Terminal window
hivemux uninstall

This:

  • removes the block between # >>> hivemux >>> and # <<< hivemux <<< from ~/.tmux.conf, ~/.config/ghostty/config and ~/.zshrc
  • removes the hivemux hooks from ~/.claude/settings.json, leaving your other hooks alone
  • removes remoteControlAtStartup from Claude Code settings if hivemux setup turned it on
  • closes the sidebars in a running tmux (restart tmux to drop the remaining key bindings)

Your tmux sessions and Claude Code conversations keep running. Running hivemux uninstall again is safe.

What stays

Section titled “What stays”

~/.local/share/hivemux keeps saved layouts, the tmux plugins and config backups. Originals of the files setup changed are in the backup folder, with timestamps:

Terminal window
ls -la ~/.local/share/hivemux/backups/

Remove the program

Section titled “Remove the program”

After hivemux uninstall, remove the program itself the way you installed it.

Homebrew:

Terminal window
brew uninstall hivemux

Git install (the install script put the source in ~/.local/share/hivemux/src). Deleting the data folder removes the source along with saved layouts, plugins and backups:

Terminal window
rm -rf ~/.local/share/hivemux

Reinstall later

Section titled “Reinstall later”
Terminal window
curl -fsSL https://hivemux.dev/install.sh | bash

See Install.