hive uninstall
Removes your user-scoped Hive install — service units, config, cache, versioned
payloads, and the hive/hv symlinks — while preserving the work Hive has
accumulated by default. Reach for it when you want to cleanly remove Hive from a
machine.
Usage
# Remove Hive, keep all state (interactive)
hive uninstall
# Remove Hive without prompts, still keep state
hive uninstall --purge
# Remove Hive AND delete accumulated state
hive uninstall --force-purge-state
Options
| Flag | What it does |
|---|---|
--purge |
Run non-interactively (no prompts). Still preserves your state. |
--force-purge-state |
The explicit destructive path — also removes Hive’s accumulated state and each registered project’s .hive-state directory. |
What it does
- Stops a running foreground daemon and bot.
- Deregisters the daemon and bot service units (launchd on macOS, systemd user units on Linux), warning and continuing if one fails.
- Removes Hive’s config, cache, and versioned data directories.
- Removes the
hiveandhvsymlinks from your bin directory.
State preservation
By default, uninstall keeps your work. It prints the state directory it is
preserving and lists each registered project’s .hive-state path. An
interactive run may ask whether to remove those project state directories;
--purge skips that prompt and keeps them.
Project .hive-state directories are only deleted when you explicitly pass
--force-purge-state.
Examples
# Clean removal that keeps every task and project state
hive uninstall --purge
# Full wipe, including project .hive-state directories
hive uninstall --force-purge-state
See Operating for related guidance.