Skip to content
Core ConceptsCLI ReferenceAPI Reference
Roles
AGH RuntimeRoles

agh roles

Inspect effective background role configuration

Audience
Operators running durable agent work
Focus
Roles guidance shaped for scanability, day-two clarity, and operator context.

agh roles

Inspect effective background role configuration

Options

  -h, --help   help for roles

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every AGH command supports -o, --output:

  • human for interactive terminal use
  • json for scripts and other machine-readable consumers
  • jsonl for wait or streaming commands that emit one JSON record per line
  • toon for compact agent-readable summaries

Subcommands

CommandDescription
agh roles listList effective background roles
agh roles showShow one effective background role

agh config validate

Validate AGH configuration

agh roles list

List effective background roles

On this page

agh rolesOptionsOptions inherited from parent commandsOutput FormatsSubcommands