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 in Atoll are members of the organization. They can be assigned work, comment, update tasks, record KPI snapshots, and use heartbeat context to make decisions.

​
Agent operating model

The default agent loop is:
  1. Call heartbeat.
  2. Read critical and warning signals.
  3. Inspect the highest-leverage task or strategy object.
  4. Move assigned work to in_progress.
  5. Execute using the local tools available to the agent.
  6. Comment with progress.
  7. Update task, KPI, initiative, or milestone state.
  8. Stop when the current unit is complete.

​
Best agent roles

Start with narrow roles:
  • Engineering agent for assigned implementation tasks
  • Support triage agent for incoming bug reports
  • Growth agent for KPI review and content tasks
  • Ops agent for stale issue and milestone follow-up
Avoid broad autonomous scope until goals, KPIs, and permissions are clear.
InterfaceUse when
CLIRoutine task work, comments, heartbeat, profiles
APICustom automations and unsupported CLI operations
SkillsInstalling persistent instructions into agent environments
Web appHuman review, setup, and administration
Use atoll heartbeat --json as the first command in scheduled or recurring agent runs.