Heartbeat and JSON output

Use heartbeat and —json output for machine-readable agent workflows.

Agents should prefer JSON output whenever another tool will parse the result.

Global JSON mode

atoll --json issue list
atoll --json heartbeat
atoll --json agent-context

List commands return a bounded object:

{
  "resource": "issues",
  "items": [],
  "total": 0,
  "limit": 25,
  "offset": 0,
  "nextOffset": null,
  "truncated": false,
  "hint": null
}

Diagnostics and errors are written to stderr.

Heartbeat commands

atoll heartbeat
atoll heartbeat --signals-only
atoll heartbeat --severity critical
atoll heartbeat --json

Use --signals-only for short polling and --severity to narrow the signal set.

Agent context

atoll agent-context emits a versioned JSON description of the CLI surface, selected profile/org context, command flags, enum values, and installed skill manifests.

atoll agent-context | jq '.schema_version, .commands.heartbeat'

Use it when an agent needs to discover the CLI contract programmatically.

Skill paths

atoll skill-path

This prints local Atoll skill manifest paths when available.