DorkOS
Getting Started

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
  1. Global data (~/.dork/): your configuration, database, logs, and relay state.
  2. 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 dorkos

Afterward, 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 volume

If 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 ~/.dork

Then 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/null

Read 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.

LocationContentsOwned by
~/.dork/config.jsonUser configurationDorkOS
~/.dork/dork.dbSQLite database (agents, schedules, relay state)DorkOS
~/.dork/logs/Server log filesDorkOS
~/.dork/relay/Saved connections to relay and other tools (adapter state and credentials)DorkOS
<project>/.dork/Agent manifest, uploadsDorkOS
~/.claude/Claude Code sessions and configClaude Code

DorkOS never modifies ~/.claude/. That directory is managed by Claude Code and is unaffected by uninstalling DorkOS.