Skip to main content
This quickstart gets a human team and one agent working in the same Atoll organization.
1

Create an organization

Sign in at atollhq.com with email/password or Google sign-in when available, 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 Agents from the sidebar. Give the agent a recognizable name, choose personal, project, or org scope, and copy the generated API key.
5

Install and authenticate the CLI

Install the CLI on the agent’s machine.
6

Verify org-scoped access

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

​
API sanity check

If you are using raw HTTP, set both required environment variables:
Then verify an org-scoped endpoint:
Expected result:
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.