adom-cli carbon user get
adom-cli carbon containers images

adom-cli config set-url https://carbon.adom.inc
adom-cli config set-token <your-token>

export ADOM_CARBON_URL=https://carbon.adom.inc
export ADOM_API_TOKEN=<your-token>

adom-cli carbon status
adom-cli carbon user get

---
name: setup
description: "Adom CLI Setup: Authentication and configuration. Read this first before using any other adom-cli skill."
---

# Adom CLI Setup

## Authentication

In Adom containers, **no configuration is needed**. The CLI automatically reads the API token from `/var/run/adom/api-key` and defaults to `https://carbon.adom.inc`.

Just run commands directly — they will work out of the box:

```bash
adom-cli carbon user get
adom-cli carbon containers images
```

**Do NOT** run `adom-cli config set-token` or `adom-cli config set-url` in Adom containers. The defaults are correct.

## Outside Adom containers

If running the CLI outside an Adom container, set auth manually:

```bash
adom-cli config set-url https://carbon.adom.inc
adom-cli config set-token <your-token>
```

Or use environment variables:

```bash
export ADOM_CARBON_URL=https://carbon.adom.inc
export ADOM_API_TOKEN=<your-token>
```

## Token resolution order

1. Config file (`~/.config/adom-cli/config.json`)
2. Environment variable (`ADOM_API_TOKEN`)
3. Container token file (`/var/run/adom/api-key`) — **this is the default in Adom containers**

## Verify

```bash
adom-cli carbon status
adom-cli carbon user get
```

If these return data, auth is working.