Keep the CLI up to date¶

Upgrade alis from the command line, understand how the TUI updates itself, and install a specific version when you need one.

Prerequisites¶

The CLI installed at ~/.alis/bin (or under ALIS_INSTALL).

Upgrade from the command line¶

Run the upgrade:
```
❯ alis upgrade
```
The latest binary for your platform is downloaded, verified against its published SHA-256 checksum and installed. The upgrade is only reported complete once the installed binary confirms its version.
Check:
```
❯ alis version
```

If another alis earlier on your PATH keeps answering with the old version, remove that copy or run alis setup path and open a new terminal.

Let the TUI update itself¶

Launching alis (the TUI) checks for updates in the background at startup and every 30 minutes after that. When the CLI itself has a new version:

The update downloads and installs silently, with no prompt and no progress screen.
Once a verified binary is in place, the footer shows a green ✓ Updated badge and press v to restart.
Press V whenever it suits you to restart into the new version, or keep working: the next launch uses it anyway.

If three attempts at the same version fail, a passive "Update failed" card appears with the exact command to run by hand, or alis upgrade. If an older copy earlier on your PATH would still be used, an "Update needs attention" card names that path so you can remove it.

Editor and agent plugin updates are not automatic. A one-time hint reads N Alis Build integrations are out of date · press V to install; press ShiftV to open Setup and install them.

Install a specific version¶

In the TUI, press ^ ("Install different version") and pick a version. A "Restart required" card follows; press Enter to restart.

From the command line, download an immutable release artifact and verify it:

Shell

curl --proto '=https' --tlsv1.2 -fsSLO "https://cli.alis.build/releases/v<version>/alis-darwin-arm64-v<version>"
curl --proto '=https' --tlsv1.2 -fsSL  "https://cli.alis.build/releases/v<version>/alis-darwin-arm64-v<version>.sha256"
shasum -a 256 "alis-darwin-arm64-v<version>"

checksums.txt for the whole release lives under the same releases/v<version>/ path. Replace darwin-arm64 with your platform.

Related: alis upgrade.