---
title: "alis upgrade"
url: "https://docs.alisx.com/reference/cli/upgrade/"
---
# alis upgrade

Download and install the latest Alis Build CLI for this platform.

## Synopsis

```bash
alis upgrade [flags]
```

## Description

The downloaded binary is verified against its published SHA-256 checksum, and the upgrade is only reported complete once the installed binary confirms its version. The TUI updates the CLI automatically in the background; this command is the manual path for scripts and for machines where the TUI is not used.

## Flags

No flags beyond the [global flags](https://docs.alisx.com/reference/cli/index.md#global-flags).

## Examples

```bash title="Terminal"
alis upgrade
alis upgrade --json
alis version
```

## Notes

- The install directory is `~/.alis/bin` unless `ALIS_INSTALL` names another.
- If a different `alis` earlier on your PATH keeps winning after an upgrade, remove the older copy or run `alis setup path`.