Install

Atlas is a desktop app. Pick the file for your machine, install it the way you install anything else on that platform, and open it.

Working in a terminal, or on a server? Install the Atlas CLI instead, or alongside it.

Requirements

Atlas itself needs no account. You sign in later, when you want Atlas Agent or your team.

macOS

1. Download the .dmg for your Mac: Apple silicon for M-series chips, Intel for older Macs. If you're not sure, open the Apple menu, choose About This Mac, and look at Chip.
2. Open the .dmg and drag Atlas into Applications.
3. Open Atlas from Applications.

On launch, Atlas puts a small atlas command in ~/.local/bin. With that folder on your PATH, run this from any project to open it in Atlas:

atlas .

If the command goes missing, reinstall it from Settings → General.

Windows

1. Download the .msi.
2. Run it. Windows asks for permission before it installs.

Atlas draws its window with Microsoft Edge WebView2. The installer fetches it if your machine doesn't have it already.

The atlas command is not available on Windows yet. Open projects from the welcome screen instead.

Linux

Atlas ships x86-64 packages. Each one installs the commands atl and tryatlas (not atlas, a name other tools already use).

sudo apt install ./tryatlas_*_amd64.deb

The package manager pulls in what Atlas needs, including WebKitGTK 4.1 and bubblewrap.

For any other distribution, use the AppImage or the tarball:

# AppImage: make it executable and run it
chmod +x tryatlas_*_amd64.AppImage
./tryatlas_*_amd64.AppImage

# Tarball: unpack it and run the installer
tar -xzf atlas-*-linux-x86_64.tar.gz
cd atlas-*-linux-x86_64
./install.sh

Run as your own user, install.sh installs into ~/.local. Run it with sudo to install into /usr/local. uninstall.sh in the same folder removes it.

Updates

On macOS and Windows, Atlas checks for a new version in the background and downloads it. When it's ready, Atlas asks you to restart to finish updating. On macOS it verifies the update's Apple signature before installing it.

On Linux, Atlas checks for a new version and tells you, but doesn't install it. Update through your package manager, or download the new package from the releases page.

To stop checking, turn off Automatic updates in Settings → Updates.

Atlas CLI

The Atlas CLI records the agents you run in a terminal and gives them shared memory, without the desktop app. It runs on macOS and Linux, on x86-64 and arm64, but not on Windows.

curl -fsSL https://github.com/tryatlas/cli/releases/latest/download/install.sh | sh

The script checks the download's checksum and puts atlas-cli in ~/.local/bin. atlas-cli update keeps it current. See Install the CLI for pinning a version or choosing the folder.

The CLI and the app share your sign-in and each project's .atlas/ folder, so you can use either, or both.

Next