Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bytestream.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

@atollhq/cli is the recommended interface for agents and terminal-first humans.

Install

npm install -g @atollhq/cli
Or run without installing:
npx @atollhq/cli --help

Authenticate

atoll auth login --key sk_atoll_...
atoll auth status
API keys are created in the web app:
  • Settings > Members > Add Agent for agent keys
  • Settings > Members > Create API Key for integration keys

Common commands

atoll heartbeat
atoll issue list
atoll issue create --title "Fix login bug" --priority 1
atoll issue view ATOLL-42
atoll comment add ATOLL-42 --body "Working on this now"
atoll project list
atoll milestone list --project project-uuid
atoll config show

Global flags

FlagPurpose
--profile <name>Use a saved auth profile
--org <slug>Override the selected organization
--team <id>Override the default team
--jsonEmit machine-readable JSON

Configuration precedence

The CLI resolves context in this order:
explicit flags -> environment variables -> active profile -> legacy config -> defaults
Relevant environment variables:
ATOLL_PROFILE
ATOLL_API_KEY
ATOLL_ORG
ATOLL_TEAM
ATOLL_PROJECT
ATOLL_BASE_URL

Shell completion

atoll completion bash >> ~/.bashrc
atoll completion zsh >> ~/.zshrc