> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.youratlas.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.youratlas.com/_mcp/server.

# Installation

## Install

#### macOS / Linux

```bash
curl -fsSL https://cdn.youratlas.com/atlas-cli/install.sh | bash
```

#### Windows PowerShell

```powershell
irm https://cdn.youratlas.com/atlas-cli/install.ps1 | iex
```

> **Note**
>
> [Git for Windows](https://gitforwindows.org/) recommended. PowerShell is used if Git Bash is absent.

#### Windows CMD

```cmd
curl -fsSL https://cdn.youratlas.com/atlas-cli/install.cmd -o install.cmd && install.cmd && del install.cmd
```

> **Note**
>
> [Git for Windows](https://gitforwindows.org/) recommended. PowerShell is used if Git Bash is absent.

The installer automatically:

* Detects your operating system and CPU architecture
* Downloads the correct binary
* Verifies the SHA-256 checksum
* Installs to `~/.atlas/bin/atlas` (macOS/Linux) or `%USERPROFILE%\.atlas\bin\atlas.exe` (Windows)
* Adds to your PATH

### Supported Platforms

| Platform | Architecture                | Binary                    |
| -------- | --------------------------- | ------------------------- |
| macOS    | Apple Silicon (M1/M2/M3/M4) | `atlas-darwin-arm64`      |
| macOS    | Intel                       | `atlas-darwin-x64`        |
| Linux    | x64                         | `atlas-linux-x64`         |
| Linux    | ARM64                       | `atlas-linux-arm64`       |
| Windows  | x64                         | `atlas-windows-x64.exe`   |
| Windows  | ARM64                       | `atlas-windows-arm64.exe` |

## Manual Install

If you prefer to install manually:

```bash
# Download the binary for your platform
curl -fsSL https://cdn.youratlas.com/atlas-cli/releases/v1.0.6/atlas-darwin-arm64 -o atlas

# Make it executable
chmod +x atlas

# Move to your PATH
sudo mv atlas /usr/local/bin/atlas

# Verify
atlas --version
```

Replace the URL with the correct binary for your platform.

## Updating

Run the install command again to update to the latest version:

```bash
curl -fsSL https://cdn.youratlas.com/atlas-cli/install.sh | bash
```

## Verify Installation

```bash
atlas --version
```

You should see something like:

```
atlas version v1.0.6
```

## Uninstall

```bash
rm -rf ~/.atlas
```

Then remove the PATH line from your `~/.zshrc`, `~/.bashrc`, or `~/.bash_profile`.