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

# CLI Overview

> Install and configure the Atlas CLI.

The Atlas CLI is a binary tool for running interactive workflows: generating issues from data files and monitoring jobs. It's available for macOS, Linux, and Windows.

## Installation

**macOS / Linux:**

```bash theme={null}
curl -fsSL https://nokia.atlas.arenaphysica.com/api/v1/cli/install.sh | bash
```

Reload your shell after installation:

```bash theme={null}
source ~/.bashrc   # or ~/.zshrc
```

**Windows:** Download the binary from `https://nokia.atlas.arenaphysica.com/api/v1/cli/download/windows-amd64`.

## Set your server URL

```bash theme={null}
atlas setup-url https://nokia.atlas.arenaphysica.com
```

## Configuration

| Location         | Description                |
| ---------------- | -------------------------- |
| `~/.atlas/token` | Saved authentication token |
| `~/.atlas/url`   | Saved server URL           |

| Variable      | Description                |
| ------------- | -------------------------- |
| `ATLAS_URL`   | Overrides saved server URL |
| `ATLAS_TOKEN` | Overrides saved token      |

## Self-update

```bash theme={null}
atlas update
```

Downloads and installs the latest CLI version from your Atlas deployment.

## Commands

| Command                                                      | Description                       |
| ------------------------------------------------------------ | --------------------------------- |
| [`atlas login`](/cli-reference/authentication)               | Authenticate with Atlas           |
| [`atlas logout`](/cli-reference/authentication)              | Remove saved credentials          |
| `atlas setup-url <url>`                                      | Set server URL                    |
| [`atlas generate-issue`](/cli-reference/issue-generation)    | Generate an issue from data files |
| [`atlas status <job-run-id>`](/cli-reference/job-management) | Check job status                  |
| [`atlas cancel <job-run-id>`](/cli-reference/job-management) | Cancel a job                      |
| [`atlas watch`](/cli-reference/job-management)               | Monitor active jobs               |
| `atlas update`                                               | Update CLI to latest version      |
| `atlas version`                                              | Show CLI version                  |