Skip to Content

ReferenceCommandsMaintenance

turno uninstall

Remove the service, launchers, status line and MCP entries turno set up (profile folders stay)

View source
turno uninstall --help
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