tidbit
Docs/Support & troubleshooting/Uninstall and unpair Tidbit

Uninstall and unpair Tidbit

3 min readUpdated July 2026

Every Tidbit install is fully reversible. This covers removing each install type and disconnecting a device: pick the section that matches how you set up.

Desktop app or CLI (the intercept install)#

Open Tidbit in your Applications folder and click Uninstall, or run:

sudo bash install.sh uninstall
  • Removes the background watchdog and its LaunchDaemon.
  • Removes the hosts redirect for the Anthropic and Claude domains.
  • Deletes the machine config under /etc/tidbit.
  • Removes and untrusts the Tidbit certificate from the System keychain.
  • Relaunches Claude back to its normal, direct connection.

Unpair a device without uninstalling#

To keep Tidbit routing but disconnect this machine’s identity, run bash install.sh unpair (no sudo needed). It asks the server to revoke this device, removes the 30-minute token-rotation agent, removes the managed shell-profile block, and deletes the local identity including the device private key. Open a new terminal (or unset ANTHROPIC_CUSTOM_HEADERS) to clear the identity from your current shell. You can also revoke a device from your device list in the Tidbit console.

API (BYOK) install#

bash install-byok.sh uninstall

Removes the managed block from your shell profile and deletes the env file at ~/.config/tidbit/byok.env, then restores anything the installer backed up at install time, including your original ~/.claude/settings.json if it wrote one. Open a new terminal (or unset ANTHROPIC_BASE_URL ANTHROPIC_API_KEY). Preview the teardown first with bash install-byok.sh uninstall --dry-run.

Verify removal#

  • Intercept: sudo bash install.sh status should report that Tidbit is not installed.
  • BYOK: bash install-byok.sh status should report "not installed", and echo "$ANTHROPIC_BASE_URL" in a fresh shell should be empty (or your own previous value, restored).
If removal does not seem to take, see Troubleshooting and support: usually an old terminal still has the variables exported, or a shell-only BYOK install never wrote ~/.claude/settings.json for the uninstall to restore.