Uninstall

When you’re done with Monoceros, one command takes it back off your machine: every workbench torn down, the runtime images purged, the CLI and its shell wiring removed. You decide whether to keep your configs and backups (so a later reinstall picks up where you left off) or wipe everything.

Only Monoceros’ own objects are touched. Docker images and volumes that belong to other tools are never removed, and the uninstaller is safe to re-run if something needs a second pass.

macOS and Linux

curl -fsSL https://raw.githubusercontent.com/getmonoceros/workbench/main/installer/uninstall.sh | bash

Run from a terminal, it shows an arrow-key menu with two scopes:

• Remove Monoceros, keep ~/.monoceros - runs monoceros remove for each workbench (backing each one up to container-backups/ first), purges the Monoceros images, and removes the CLI and its PATH/completion lines. Your configs and backups stay, so a reinstall resumes.
• Remove everything - the same, but with --no-backup, and then deletes ~/.monoceros (configs and backups included). This can’t be undone, so it asks you to type monoceros to confirm.

Windows

irm https://raw.githubusercontent.com/getmonoceros/workbench/main/installer/uninstall.ps1 | iex

On Windows, Monoceros lives in its managed WSL distro, so the two scopes differ:

• Keep the distro - runs monoceros remove for each workbench (backed up first), purges the Monoceros images, de-integrates from Docker, and removes the Windows wiring (the monoceros shim and the %USERPROFILE%\.monoceros link). The distro and your data are kept.
• Remove everything - the same, with --no-backup, and then wsl --unregister on the managed distro, which deletes it and all data inside it. This is irreversible, so it asks you to type the distro name (monoceros) to confirm.

Reinstall

Kept your data? Reinstalling is just the install command again - your configs and backups are still in ~/.monoceros, so your workbenches come back with monoceros apply <name>.