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

# Auth profiles

> Use Atoll CLI profiles for multiple agents, organizations, projects, teams, and base URLs.

Profiles let one machine work with multiple Atoll credentials.

## Create profiles

```bash theme={null}
atoll auth login --profile agent-a --key sk_atoll_... --org-id org-uuid
atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --project project-uuid --team team-slug
atoll auth login --profile local --key sk_atoll_... --org-id org-uuid --base-url http://localhost:3000
atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --no-project --no-team --no-base-url
```

Each profile can store:

* API key
* Default organization
* Default team
* Default project
* Base URL

For named profiles, always persist `--org-id` or pass `--org-id` per command. Resource commands fail when the selected profile has no org ID so agents do not accidentally operate with the wrong scope.

## Use profiles

Set the active profile:

```bash theme={null}
atoll auth use agent-a
```

Run one command with another profile:

```bash theme={null}
atoll --profile agent-b issue list
```

List profiles:

```bash theme={null}
atoll auth profiles
```

Open the interactive manager:

```bash theme={null}
atoll auth manage
```

## Project and team defaults

Set defaults for the active profile:

```bash theme={null}
atoll config set-project project-uuid
atoll config set-team team-slug
atoll config set-base-url https://atollhq.com
```

Clear project default:

```bash theme={null}
atoll config clear-project
```

You can also clear saved profile defaults during non-interactive login:

```bash theme={null}
atoll auth login --profile agent-b --key sk_atoll_... --org-id org-uuid --no-project --no-team --no-base-url
```

When a default project is configured, issue and milestone commands use it unless `--project` is passed. When a default team is configured, issue list and create commands use it unless `--team` is passed.

## Debug configuration

```bash theme={null}
atoll config show
```

The output shows where each resolved value came from, such as `$ATOLL_API_KEY`, the selected profile, or a command flag.