ReferenceCommandsMaintenance
turno uninstall
Remove the service, launchers, status line and MCP entries turno set up (profile folders stay)
Usage: turno uninstall [--dry-run] [--yes] [--keep-config] [--purge]
Removes what turno set up on this machine, then tells you the command that
removes the package itself:
- the mcpd service (LaunchAgent or systemd user unit), and stops mcpd
- the MCP entries turno mcp sync added to agent configs (your own entries stay)
- the status line turno ui install set (the one you had before comes back)
- the launchers turno wrote in ~/.local/bin (claude-<name>, turno-auto, ...)
- turno's fish completion file, and the gateway token
- ~/.config/turno (config.toml, mcp.toml, accounts.toml), unless --keep-config
Profile folders (~/.claude-<name> and the like) hold your logins and history:
they stay, and the list says where they are. So do turno's backups under
~/.local/state/turno, which let `turno undo <stamp>` put everything back
before you remove the package. Lines that load turno in your shell startup
files are listed for you to remove by hand.
--purge also removes turno's state and caches: ~/.local/state/turno (backups,
logs, usage, exhausted marks), ~/.cache/turno, and the MCP servers and caches
under ~/.local/share/turno. Then turno undo cannot put anything back. Browser
profiles with logins (~/.local/share/turno/chrome and browser) and profile
folders still stay.
--dry-run print the list and change nothing
--yes do not ask (needed when there is no terminal to ask in)
--keep-config keep ~/.config/turno
--purge remove turno's state and caches too (no undo)
Examples:
$ turno uninstall --dry-run
$ turno uninstall --yes --keep-config