Uninstall
Remove DorkOS and its data completely, in one command or by hand.
Uninstall
Ready to remove DorkOS? One command handles almost everything.
Quick uninstall
Run dorkos cleanup. It walks you through removing:
dorkos cleanup- Global data (
~/.dork/): your configuration, database, logs, and relay state. - Per-project data (
.dork/directories): agent manifests and uploads.
You'll see each item listed before you confirm, so nothing disappears by surprise.
Once that's done, remove the CLI itself:
npm uninstall -g dorkosAfterward, dorkos should no longer run, and ~/.dork should be gone. DorkOS is fully off your machine.
Docker
If you run DorkOS in Docker, remove the container and its volume:
docker rm -f dorkos
docker volume rm dorkos-data # if you used a named volumeIf you followed the Docker guide, your volume is named dorkos-data unless you changed it.
Obsidian plugin
The Obsidian plugin is early and still being tested, but uninstalling it is simple. In Obsidian, go to Settings > Community plugins, disable DorkOS, then click Uninstall. The plugin keeps its data inside your vault, so removing it doesn't touch anything outside Obsidian.
Desktop app
The desktop app shares the same ~/.dork data and CLI as everything else. It doesn't keep a separate data folder, so running dorkos cleanup (or the manual steps below) removes its data too. To remove the app itself, drag it out of your Applications folder (macOS) or uninstall it the way you would any other app on your system.
Manual cleanup
Prefer to remove things by hand, or don't have the CLI installed anymore? Start with your global data:
# Remove global data
rm -rf ~/.dorkThen find any per-project folders. This command searches your home directory for .dork folders and only lists them, it deletes nothing on its own:
# Find per-project agent directories (lists matches, doesn't delete)
find ~ -name ".dork" -type d -path "*/.dork" 2>/dev/nullRead the list, then delete only the folders that are actually DorkOS's. .dork is a popular name for reasons that have nothing to do with us, so double-check before you run rm -rf on anything it finds.
What DorkOS stores
Curious exactly what gets removed? Here's the full inventory.
| Location | Contents | Owned by |
|---|---|---|
~/.dork/config.json | User configuration | DorkOS |
~/.dork/dork.db | SQLite database (agents, schedules, relay state, conversations) | DorkOS |
~/.dork/backups/ | Automatic spare copies of that database (see the warning below) | DorkOS |
~/.dork/logs/ | Server log files | DorkOS |
~/.dork/relay/ | Saved connections to relay and other tools (adapter state and credentials) | DorkOS |
<project>/.dork/ | Agent manifest, uploads | DorkOS |
~/.claude/ | Claude Code sessions and config | Claude Code |
~/.dork/backups/ holds the only spare copies of your channels, DMs, and threads. Deleting
~/.dork deletes those too. If you might want that history later, move the newest file out of
backups/ first. Each one is a complete database on its own.
DorkOS never modifies ~/.claude/. That directory is managed by Claude Code and is unaffected by
uninstalling DorkOS.