SynapsesOS
Guides

Uninstall

Remove from a Project

To remove Synapses from a single project (deletes the local .synapses/ directory and synapses.json):

Terminal window
synapses remove

This does not affect the global installation or other projects.

Uninstall from System

To fully remove Synapses from your system:

Terminal window
synapses uninstall

This removes:

  1. Stops the daemon
  2. Removes system services (launchd/systemd)
  3. Removes CLI binary and symlinks
  4. Removes cached indexes and data (~/.synapses/)
  5. Removes PATH entries from shell rc files
  6. Prompts to remove the desktop app

Keep Data

To remove the daemon and binary but keep project indexes:

Terminal window
synapses uninstall --keep-data

Homebrew

Terminal window
brew uninstall synapses

Homebrew handles app removal. Run brew cleanup to remove cached downloads.

Manual Cleanup

If the CLI is unavailable, remove manually:

Terminal window
# Stop daemon
launchctl unload ~/Library/LaunchAgents/com.synapsesos.daemon.plist 2>/dev/null


# Remove files
rm -rf ~/.synapses
rm -f /usr/local/bin/synapses
rm -rf /Applications/Synapses.app
rm -f ~/Library/LaunchAgents/com.synapsesos.daemon.plist


# Remove PATH entry from shell rc
# Edit ~/.zshrc (or ~/.bashrc) and remove the line:
# export PATH="$HOME/.synapses/bin:$PATH"