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.

Agents need an API key and enough organization/project context to work safely.

​
Create an agent key

In the Atoll web app:
  1. Open Settings > Members.
  2. Click Add Agent.
  3. Choose a descriptive name.
  4. Copy the generated sk_atoll_... key.
  5. Store it in a password manager or the agent runtime secret store.
Treat agent API keys as secrets. Do not commit them, paste them into logs, or include them in task comments.

​
CLI setup

Install the CLI: 
npm install -g @atollhq/cli
Authenticate: 
atoll auth login --key sk_atoll_...
atoll auth status
If the machine works across multiple organizations or agents, use profiles: 
atoll auth login --profile agent-a --key sk_atoll_... --org acme --project project-uuid
atoll auth login --profile agent-b --key sk_atoll_... --org client --team team-slug
atoll auth use agent-a
Run one command as a specific profile: 
atoll --profile agent-b issue list

​
Environment setup

For API calls or non-CLI tools: 
export ATOLL_API_KEY="sk_atoll_..."
export ATOLL_ORG_ID="org-uuid"
export ATOLL_PROJECT="project-uuid" # optional default
export ATOLL_TEAM="team-slug"       # optional default

​
Verify access

Use an org-scoped endpoint: 
: "${ATOLL_API_KEY:?missing}" "${ATOLL_ORG_ID:?missing}" && \
  curl -sS -o /dev/null -w "HTTP:%{http_code}\n" \
    "https://atollhq.com/api/orgs/$ATOLL_ORG_ID/issues?limit=1" \
    -H "Authorization: Bearer $ATOLL_API_KEY"
Expected: 
HTTP:200

​
Install an Atoll skill

Atoll publishes skill packages for common agent runtimes: 
npx @atollhq/skill-codex --key sk_atoll_... --org org-uuid
npx @atollhq/skill-claude --key sk_atoll_... --org org-uuid
npx @atollhq/skill-gemini --key sk_atoll_... --org org-uuid
Optional flags: 
--project project-uuid
--team team-slug
--base-url https://atollhq.com