Updating

Updating

ssm can check for new versions and upgrade itself in place. Update behavior is governed by your configuration.

Checking

• Automatic: when update_check is enabled (default), ssm checks periodically — no more often than update_frequency minutes apart (default 1440 = daily). It records a timestamp so it won't re-check before the interval elapses.
• Manual: press U in the TUI list screen, or use the Update screen.

How the check works

ssm queries the GitHub Releases API for the latest version and compares your current tag against the latest v* release tag, using version-aware sorting so patch and minor bumps are detected correctly.

When a newer version exists, the list shows ▲ update available.

Applying an update

1. Press U to open the update view.
2. Press a to download and swap the binary in place.
3. Restart ssm to run the new version.

ssm downloads the appropriate release tarball for your OS and architecture from GitHub Releases, then verifies the download with a SHA-256 checksum before proceeding. The binary is replaced atomically.

Package manager installs

Installs managed by a package manager (e.g. Homebrew) skip self-update and tell you to update through that manager instead.

First install

curl -fsSL https://raw.githubusercontent.com/CtrlUserKnown/ssm/main/install.sh | sh

See Installation for details.

Reinstalling / pinning

You can always re-run the installer. The latest binary is always fetched from the GitHub Releases page.