Roles

AGH RuntimeRoles

agh roles show

Show one effective background role

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

agh roles show

Show one effective background role

agh roles show <role> [flags]

Options

  -h, --help               help for show
      --workspace string   Resolve the role from a workspace id, name, or path

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

Example:

agh roles show <role> -o json

agh roles list

List effective background roles

agh update

Check for and apply the latest stable AGH release

On this page

agh roles show Options Options inherited from parent commands Output Formats