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:
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
| Flag | Purpose |
|---|
--profile <name> | Use a saved auth profile |
--org <slug> | Override the selected organization |
--team <id> | Override the default team |
--json | Emit 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