Skip to main content
Profiles let one machine work with multiple Atoll credentials.

​
Create profiles

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: 
atoll auth use agent-a
Run one command with another profile: 
atoll --profile agent-b issue list
List profiles: 
atoll auth profiles
Open the interactive manager: 
atoll auth manage

​
Project and team defaults

Set defaults for the active profile: 
atoll config set-project project-uuid
atoll config set-team team-slug
atoll config set-base-url https://atollhq.com
Clear project default: 
atoll config clear-project
You can also clear saved profile defaults during non-interactive login: 
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

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