> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrading the AppSignal CLI

> Update appsignal-cli with Homebrew, the install script, or a direct download to get updates, bug, and security fixes, then refresh the agent skill.

New releases include updates, bug and security fixes, so keep AppSignal up to date. The CLI warns you when a newer version is available. A new major version stops commands until you upgrade.

## Upgrade the CLI

Upgrade with the same method you used to install the CLI.

> [!NOTE]
>
> Before a major upgrade, read the [changelog](https://github.com/appsignal/appsignal-cli/blob/main/CHANGELOG.md). A major version can remove commands or change how you sign in. For example, 2.0.0 made sign-in OAuth-only and removed the `apps orgs` command. If the CLI asks you to sign in again, run `appsignal-cli auth login`.

> [tab] Homebrew
>
> Update Homebrew, then upgrade the formula:
>
> ```sh theme={null}
> brew update
> brew upgrade appsignal-cli
> ```
>
> Homebrew installs the version in the `appsignal/appsignal-cli` tap's formula. The tap is updated after each release on GitHub.

> [tab] Install script (macOS & Linux)
>
> Run the install command again. It downloads the latest release and verifies it against the published `SHA256SUMS` manifest before installing:
>
> ```sh theme={null}
> curl -sSL https://github.com/appsignal/appsignal-cli/releases/latest/download/install.sh | sudo sh
> ```

> [tab] Direct download
>
> Download the binary for your platform from the [latest release](https://github.com/appsignal/appsignal-cli/releases/latest/). Put it on your `PATH` in place of the old one.

## Check the version

Confirm the CLI runs the new version:

```sh Shell theme={null}
appsignal-cli --version
```

Run `appsignal-cli about` for an overview of your setup, including its version, endpoint, default organization, and authentication status.

## Update the agent skill

If you installed the [AppSignal agent skill](https://docs.appsignal.com/cli/skill.md), refresh it after you upgrade. The skill has its own version, separate from the CLI's. To update it for every agent:

```sh Shell theme={null}
appsignal-cli skill update --target all
```

Run `appsignal-cli skill status` to check that each install shows `up_to_date`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.