Installation

The Atlas is an npm package. It needs Node.js 22 or newer.

Install

Install Node.js 22+ (skip if node --version already prints 22 or higher):
Terminal window
```
winget install OpenJS.NodeJS.LTS
```
Or download the installer from nodejs.org. Open a new terminal afterwards.
Install The Atlas:
Terminal window
```
npm i -g the-atlas
```
Start it:
Terminal window
```
atlas
```

Install Node.js 22+ (skip if node --version already prints 22 or higher):
Terminal window
```
brew install node
```
Or download the installer from nodejs.org.
Install The Atlas:
Terminal window
```
npm i -g the-atlas
```
Start it:
Terminal window
```
atlas
```

Install Node.js 22+ (skip if node --version already prints 22 or higher). Distribution packages are often older; use nodejs.org or a version manager such as nvm:
Terminal window
```
nvm install 22
```
Install The Atlas:
Terminal window
```
npm i -g the-atlas
```
If npm fails with EACCES, your global npm folder belongs to root. Use nvm, or set a user prefix (npm config set prefix ~/.local) instead of sudo.
Start it:
Terminal window
```
atlas
```

Check the install

atlas --version
atlas doctor

atlas doctor checks Node, npm, git, bash and Python, shows what it detected about your terminal, and pings every connected provider.

Update

npm i -g the-atlas@latest

Your keys, chats and settings live in ~/.the-atlas/ and survive updates.

Uninstall

npm uninstall -g the-atlas

This keeps your data. To remove keys, chat history and settings too, delete the data folder:

Remove-Item -Recurse -Force "$env:USERPROFILE\.the-atlas"

rm -rf ~/.the-atlas

rm -rf ~/.the-atlas

If you set ATLAS_HOME, delete that folder instead. If you installed the Claude Code status line, remove the statusLine entry from ~/.claude/settings.json.

Quickstart: connect a free AI and ask your first question.