> Godmode v0.20.0 documentation · Reviewed 2026-11-19
> Source: https://godmode.build/docs/v0.20.0/updates

# Updates and removal

Update the CLI through its managed installer. Your key files, profiles, and agent notes stay on disk.

## Update

```sh
godmodeup
godmode --version
```

Use `godmode update` or **Settings → Update Godmode** to invoke the same updater. It reads the release manifest on `godmode.build`, checks the archive's SHA-256, and keeps the previous executable as `godmode.previous`. A current installation needs no new archive.

To select a published release, use `godmodeup --version v0.20.0`. See [release notes](/changelog) for what's changed. Update the [member pack](/docs/v0.20.0/membership#update-instructions) separately.

## Install a downloaded archive

Download the [v0.20.0 installer](/releases/v0.20.0/install.sh), [checksums](/releases/v0.20.0/SHA256SUMS), and the archive for your platform from [Release files](/install#release-files). For Apple Silicon:

```sh
sh install.sh --archive godmode-v0.20.0-aarch64-apple-darwin.tar.gz \
  --checksum SHA256SUMS --install-only
```

Use the corresponding archive for Intel macOS or Linux. This installation can run offline. Add `--path` if you want the installer to update a supported shell's startup files.

## Check the local setup

```sh
godmode doctor
godmode doctor --json
```

Doctor checks the installation, selected files, and detected agent notes. Failed checks return exit status 1. Use a provider's read-only check to verify account access.

## Recover a failed update

Run `command -v godmode` and `godmode --version` to identify the executable on PATH. To repair or roll back a managed install with downloaded files, run `godmodeup --archive PATH --checksum SHA256SUMS` with a verified archive and its matching checksum. `godmode.previous` holds the former executable only, so copying it over the installed file can leave the updater's receipt out of sync. See [Get help](/docs/v0.20.0/support).

## Migrate an older plaintext store

Check `godmode path` first. Switch any direct file readers to `godmode run`, then run `godmode migrate` to seal an older plaintext store. Keep a private recovery copy until the new workflow works. Migration stops on malformed or ambiguous entries.

## Remove programs and keep data

For a default install, remove the program files and shell helper:

```sh
rm -f ~/.godmode/bin/godmode ~/.godmode/bin/godmodeup \
  ~/.godmode/bin/godmode.previous ~/.godmode/bin/.godmode-install-receipt \
  ~/.godmode/env
```

Remove the matching `# Godmode` block from any startup file changed by `--path`. Keep the rest of the Godmode home to retain credentials and business details. Revoke credentials through their provider if you want to remove account access.
