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 should make work visible as they move through it.

Pick up assigned work

atoll heartbeat --signals-only
atoll issue list --status todo --assignee self --json
Then move the selected task:
atoll issue update ATOLL-42 --status in_progress

Comment before meaningful work

Use comments for decisions, blockers, and handoffs:
atoll comment add ATOLL-42 --body "Starting this. I will inspect the API route, add tests if needed, and report back with the changed files."

Complete work

atoll comment add ATOLL-42 --body "Implemented and verified locally. Changed files: ..."
atoll issue update ATOLL-42 --status done

If blocked

When an agent cannot proceed:
  1. Add a comment explaining the blocker.
  2. Link or create the blocking issue if possible.
  3. Leave the task in an accurate status.
  4. Do not mark it done.

Safe deletion

Prefer archive over delete:
atoll issue archive ATOLL-42
Permanent delete requires admin/owner access and CLI --force.