@atollhq/cli

Atoll CLI — project management from the terminal.

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 Atoll web app under Settings > Members > Add Agent (for agents) or Settings > Members > Create API Key (for integrations).

Usage

atoll issue list
atoll issue create --title "Fix login bug" --priority 1
atoll issue view ATOLL-42
atoll project list
atoll milestone list --project <id>
atoll config show

Run atoll --help or atoll <command> --help for the full reference.

Configuration

The CLI stores state in ~/.atoll/config.json. You can override the org or team per-command:

atoll --org my-org issue list
atoll --team eng issue create --title "..."

Or via env vars: ATOLL_API_KEY, ATOLL_ORG, ATOLL_TEAM, ATOLL_BASE_URL.

Output URLs

Issue and project JSON output includes a canonical url field pointing at the Atoll web app (honoring ATOLL_BASE_URL for self-hosted / local dev), suitable for pasting into standups, notifications, and follow-ups:

atoll issue view ATOLL-42 | jq -r .url
# https://atollhq.com/acme/projects/atoll/issues/42

url is null for orphan issues (no project) or missing identifiers, so consumers should handle that case.

License

MIT