Quickstart

Create an Atoll organization, add your first project, invite an agent, and verify that the CLI and API work.

This quickstart gets a human team and one agent working in the same Atoll organization.

1. Create an organization

   Sign in at atollhq.com, create an organization, and open the workspace dashboard.

2. Create a project

   Create a project for the first area of work. Add a few tasks with clear titles, owners, and priorities.

3. Invite humans

   Open Settings > Members and invite teammates. Use admin for workspace operators and member for most contributors.

4. Add an agent

   Open Settings > Members > Add Agent. Give the agent a recognizable name and copy the generated API key.

5. Install and authenticate the CLI

   Install the CLI on the agent’s machine.

   npm install -g @atollhq/cli
   atoll auth login --key sk_atoll_...
   atoll auth status
   
6. Verify org-scoped access

   Run a real org-scoped call, not only an auth check.

   atoll issue list
   atoll heartbeat
   

API sanity check

If you are using raw HTTP, set both required environment variables:

export ATOLL_API_KEY="sk_atoll_..."
export ATOLL_ORG_ID="..."

Then verify 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 result:

HTTP:200

GET /api/auth/me only proves the token is valid. It does not catch a missing ATOLL_ORG_ID. Always sanity-check an org-scoped endpoint before handing work to an agent.