Upgrade and Uninstall

Upgrade and Uninstall

Upgrade with Homebrew

brew update
brew upgrade --cask aziron-ai/atlas/atlas
atlas version

Upgrade with npm

npm install -g @aziron/atlas
atlas version

Pin a version for reproducible automation:

npm install -g @aziron/atlas@0.1.43

For GitHub Packages installations, use @aziron-ai/atlas@0.1.43 with the existing registry authentication.

Post-Upgrade Checks

atlas bootstrap
atlas migrate
atlas status --schema
atlas doctor --verify atlas

Bootstrap refreshes assistant configuration that contains an absolute Atlas binary path. Migration upgrades supported database schemas in place.

Run a full rebuild only when status, doctor, or release notes require it:

atlas index . --reindex

Before Downgrading

Back up the full .atlas/ directory. Do not assume an older binary can open a database already migrated by a newer release.

Use a separate database for downgrade testing when possible.

Remove Assistant Integrations

Preview:

atlas uninstall --dry-run

Apply:

atlas uninstall

Atlas removes the entries and skills it manages while preserving unrelated assistant configuration. Bootstrap merges (not replaces) on re-run, so a --db pin or custom env you added survives an upgrade.

To also delete the index databases, add --purge:

atlas uninstall --purge

This removes the .atlas directories (the global ~/.atlas and every registry-known repo's .atlas), printing the blast radius and total reclaimed space first and requiring confirmation (--yes to skip, --dry-run to preview). Plain uninstall leaves them and prints a one-line reminder.

Remove the Package

Homebrew:

brew uninstall --cask aziron-ai/atlas/atlas

npm:

npm uninstall -g @aziron/atlas
npm uninstall -g @aziron-ai/atlas  # GitHub Packages alternative

Manual binary:

sudo rm /usr/local/bin/atlas

Remove Repository Data

Package removal does not delete indexes. After stopping all Atlas processes and verifying the repository path:

rm -rf /absolute/path/to/repository/.atlas

This permanently removes the local index, settings, retrieval data, telemetry, and retained snapshots for that repository.

Remove User-Level Atlas Data

After reviewing the directory:

rm -rf "$HOME/.atlas"

Do this only when all user-level Atlas data and installed Atlas skills should be removed.

Verify Removal

command -v atlas || true

Also inspect the assistant configuration locations listed in AI Assistant Setup if a client was configured manually.