Uninstall

burrowee uninstall clears the CLI's state from your machine. By default it is non-destructive: your pairing is backed up, not deleted, so you can change your mind.

Backup mode (the default)

burrowee uninstall

This moves your state home aside rather than deleting it:

• ~/.burrowee/cli is renamed to ~/.burrowee/cli.bak.<timestamp> (e.g. cli.bak.20260612-153045) — config, gateway key, and PSK all preserved;
• the daemon's transport socket is removed.

backed up /home/you/.burrowee/cli → /home/you/.burrowee/cli.bak.20260612-153045
removed transport socket ~/.burrowee/cli/sockets/transport.sock

Running it again when there's nothing left is a harmless no-op (nothing to back up at …).

To restore a backup, just rename the directory back:

mv ~/.burrowee/cli.bak.20260612-153045 ~/.burrowee/cli

Purge mode

burrowee uninstall --purge

Purge deletes everything outright: the state home and every prior *.bak.* backup, printing one removed … line per path. There is no recovery — your pairing keys are gone, and re-pairing requires the gateway operator's involvement (below). Use it when you're decommissioning a machine or handing it to someone else.

Flags

Flag	Meaning
--purge	delete all files instead of backing up state
--home <dir>	cli state dir to uninstall (default ~/.burrowee/cli)
--config <path>	config.json path; its parent dir is used as the home (overrides --home)

What it doesn't do

Uninstall manages state, not processes or binaries:

• A running burrowee daemon is not stopped — uninstall reminds you: the burrowee daemon is unmanaged — stop any running burrowee daemon yourself (Ctrl-C or kill). If you installed the managed service, unload it too (launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/org.burrowee.cli.plist on macOS, systemctl --user disable --now burrowee-cli.service on Linux) and delete the unit file.
• The binaries stay on disk; remove them the way you installed them (see Install).

Re-pairing afterwards

After a backup-mode uninstall, restoring the directory brings the old pairing back as-is. After a purge, you start over: the gateway operator should revoke the old client pairing in the gateway's local console (your old key can no longer be used, but tidiness counts), mint a fresh blob + PIN, and you run burrowee bootstrap again.