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

> ## Agent Instructions
> To act on Atlan objects, use the Atlan MCP server at https://api.atlan.com/mcp or the atlanai CLI; `atlanai --map json` prints its command map. Run a read-only identity check before any write.
> The docs MCP server at /mcp searches these docs only. It cannot read or change Atlan objects.
> SDK packages: Python `atlanai` (PyPI) and TypeScript `@atlanai/sdk` (npm). Show Python first, then TypeScript.

# Update CLI

> Update the atlanai CLI to the latest version while keeping your local state and credentials intact.

Update the CLI by rerunning the same installer you used to install it. The update replaces the binary and restarts the daemon. Your credentials, workspace contexts, and local trace data are not affected.

## Before you start

* Confirm the CLI is installed. See [Install atlanai CLI](/tools/cli/how-tos/install) if you need to install it for the first time.
* Run `atlanai doctor` before updating to establish a passing baseline. If the health check already fails, fix those issues first so you can tell whether the update caused any new failures.
* For CI environments: coordinate binary updates to avoid disrupting pipelines that are mid-run. Schedule the update during a low-traffic window and confirm `atlanai doctor` passes in the updated environment before enabling job traffic.

<Steps>
  <Step title="Check your current version">
    Note the version string before updating so you can confirm the upgrade succeeded.

    ```bash theme={null}
    atlanai version
    ```
  </Step>

  <Step title="Run installer">
    The installer replaces the binary, restarts the daemon, and retains the previous runtime so you can roll back if needed.

    <Tabs>
      <Tab title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://api.atlan.com/install.sh | sh
        ```

        If `atlanai` is not found after the update, open a new terminal window or run `source ~/.zshrc` (or your shell's equivalent) to pick up the updated PATH.
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={null}
        irm https://api.atlan.com/install.ps1 | iex
        ```

        Open a new PowerShell window after the install so the updated PATH takes effect.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Confirm update">
    * **Check version**: Verify the version string changed from the one you noted in Step 1.

      ```bash theme={null}
      atlanai version
      ```

    * **Run health check**: Reports local paths, configured gateway URL, credential source, and daemon state. Compare the output against your pre-update baseline.

      ```bash theme={null}
      atlanai doctor
      ```

    If the new version causes issues, run `atlanai trace runtime rollback` to restore the previous runtime.
  </Step>
</Steps>

## Troubleshooting

For installer failures, post-update regression, or PATH issues, see [CLI update errors](/tools/cli/troubleshooting/cli-update-errors).

## Next steps

* [Validate and publish skill](/tools/cli/how-tos/skills): Validate and push skills to the Registry.

## See also

* [Install atlanai CLI](/tools/cli/how-tos/install): First-time installation steps.


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