---
title: "Keep the CLI up to date"
url: "https://docs.alisx.com/how-to/cli/keep-the-cli-up-to-date/"
---
# 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

1. Run the upgrade:

    ```bash title="Terminal"
    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.

2. Check:

    ```bash title="Terminal"
    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:

1. The update downloads and installs silently, with no prompt and no progress screen.
2. Once a verified binary is in place, the footer shows a green `✓ Updated` badge and `press v to restart`.
3. 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 ++shift+v++ to open Setup and install them.

## Install a specific version

In the TUI, press ++caret++ ("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:

```bash title="Terminal"
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](https://docs.alisx.com/reference/cli/upgrade.md).