Skip to main content
The uninstall command asks before it deletes session data or the executable.

​
Uninstall

1

Start the uninstall

Run:
2

Review integration removal

Handshake stops the daemon, removes the login service, and removes managed registrations, hooks, plugins, and skills.
3

Select whether to delete local data

Keep ~/.handshake when you want to preserve sessions and project knowledge. Delete it when you do not require this data.
4

Select whether to delete the binary

Confirm binary removal when required. A Homebrew installation uses brew uninstall handshake.

​
Stop Handshake without uninstalling

Remove only the login service:
This command keeps agent registrations and local data. Start the daemon again with:
Or reinstall the service:

​
Reinstall with preserved data

Install Handshake again and run:
Handshake opens the existing ~/.handshake/sessions.db and protects the database files with owner-only permissions.