Remove Waycar from a Host

To remove Waycar from a Host, take out its Status Hooks, unlink the herdr plugin, delete the installed files, and remove your device’s SSH key. Then delete the Host in the app. Your agents, herdr and tmux keep working as before.

1. Remove the Status Hooks

Run this first, while the waycar command is still there:

waycar hooks uninstall

It removes only Waycar’s entries from Claude Code and Codex, and deletes the Waycar extension files for omp, pi and opencode, including the opencode Chat Prompt extension. Every other hook stays. For each agent it prints removed Waycar hooks from … or no Waycar hooks.

If waycar isn’t on your PATH, run ~/.local/share/waycar/plugin/bin/waycar hooks uninstall instead. The files it touches are listed in Waycar hooks for tmux.

2. Unlink the herdr plugin

On a Host with herdr, first run herdr plugin config-dir waycar and note the folder it prints. You need it in step 4. Then run:

herdr plugin unlink waycar

If herdr says the plugin isn’t linked, use herdr plugin uninstall waycar. Run herdr plugin list to check that waycar is gone. Skip this step on a tmux-only Host.

3. Delete the installed files

rm -rf ~/.local/share/waycar/plugin
[ -L ~/.local/bin/waycar ] && rm ~/.local/bin/waycar

The second line removes ~/.local/bin/waycar only if it’s a link, which is all the install command ever puts there.

If you installed with WAYCAR_PLUGIN_DIR, delete that folder instead.

4. Delete the pairing and notification keys (optional)

Waycar keeps its config, with the pairing and notification keys, so a reinstall picks up where you left off. To remove it too:

• On tmux, delete ~/.config/waycar (or $XDG_CONFIG_HOME/waycar) and ~/.local/state/waycar.
• On herdr, herdr keeps the plugin’s config folder after you unlink it. Delete the folder you noted in step 2.

5. Remove your device’s SSH key

Open ~/.ssh/authorized_keys on the Host and delete the line for your Waycar device key. It’s the line you added by hand or that pairing added. See SSH keys and passwords. If several devices share it through iCloud Sync, removing it signs them all out of this Host.

6. Delete the Host in the app

In Waycar, tap Hosts, swipe left on the Host’s card (or touch and hold it), tap Delete, and confirm with Remove Host. See Remove a Host.

Good to know

• To only take a break from a Host, turn off its switch in the Hosts sheet instead.
• To put Waycar back later, run the install command again. See Install Waycar on your Host.