Update the CLI

Check the installed Ansight CLI release, apply updates, change channels, or recover with the standalone platform updater.

CLI v0.23.1

Ansight CLI releases have a human version, a daily YYYYMMDDNN build number, and a public or preview update channel. The installation receipt preserves the selected channel and managed install locations.

Check the installed release

Show the current build identity, runtime, executable path, and update channel:

ansight version
ansight version --json

Check the installed channel for a newer build without changing the current installation:

ansight update check

The CLI also checks its installed feed at most once per day during interactive use and prints a non-blocking suggestion when a newer build is available.

Apply an update

Install the newest build from the current channel:

ansight update

The platform installer validates the release archive’s SHA-256 before changing the active CLI. Account, agent-skill, startup, and PATH setup are not repeated.

To inspect or move to another release channel:

ansight update check --channel preview
ansight update --channel preview

Select an exact release by supplying both identity components:

ansight update check --version <version> --build-number <YYYYMMDDNN>
ansight update --version <version> --build-number <YYYYMMDDNN>

Use --json with checks or updates when a script needs structured output. See the version and update command reference for the complete option contract.

Use the standalone updater

If the installed CLI cannot update itself, use the matching platform updater. On macOS or Linux:

curl -fsSL https://www.ansight.ai/update.sh | bash

On Windows PowerShell:

irm https://www.ansight.ai/update.ps1 | iex

The standalone updater discovers the installation receipt, preserves its channel and install locations, downloads the selected release, and delegates to the checksum-validating installer. It does not rerun account, agent-skill, startup, or PATH setup.

Check what the standalone updater would select without installing it:

curl -fsSL https://www.ansight.ai/update.sh | bash -s -- --check

For Windows, download the script before passing PowerShell parameters:

$updater = Join-Path $env:TEMP 'ansight-update.ps1'
irm https://www.ansight.ai/update.ps1 -OutFile $updater
& $updater -Check

Run a downloaded update.sh --help or Get-Help .\update.ps1 for standalone channel and exact-build options.