Skip to main content

Uninstall

Remove Harmony from Windows, macOS, or Linux, and where your data lives if you want it gone too.

Remove the app

Close Harmony and any open nala terminal sessions first. Stop the daemon if it is still running:

nala daemon stop
  • Windows: Settings → Apps → Harmony → Uninstall. That removes the app, shortcuts, and nala / wmux CLI shims under %LOCALAPPDATA%\NALA\.
  • macOS: quit Harmony, then move /Applications/NALA.app (or ~/Applications/NALA.app) to Trash. Remove the shim if present: rm -f ~/.local/bin/nala ~/.local/bin/wmux.
  • Linux (DEB): sudo apt remove nala (or dpkg -r nala).
  • Linux (RPM): sudo dnf remove nala (or rpm -e nala).
  • Linux (AppImage): delete the AppImage (often ~/.local/opt/nala/ or ~/.local/bin/nala-desktop) and shims in ~/.local/bin/nala.

Your data is kept by default

Uninstalling removes the program, not your data. Sessions, scrollback, tasks, and settings live separately so an upgrade or reinstall can pick them up:

PlatformData directory (typical)
Windows%APPDATA%\NALA\ and legacy %APPDATA%\wmux\
macOS~/Library/Application Support/NALA/ and legacy ~/.config/wmux/
Linux${XDG_CONFIG_HOME:-~/.config}/NALA/ and legacy ~/.config/wmux/

Delete those directories only if you want a clean removal of history and settings. Prefer exporting anything you care about first.

MCP registration

If you registered Harmony as an MCP server with Claude, Codex, or Gemini, unregister so agent configs do not point at a missing binary:

nala mcp unregister
# or legacy:
wmux mcp unregister

See MCP integration.

Reinstalling

The one-line installer works the same way again. Kept data is picked up on first launch; a deleted data directory starts fresh.