Agent

AGH RuntimeAgent

agh agent list

List installed agent definitions

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

agh agent list

List installed agent definitions

agh agent list [flags]

Examples

  # Show every agent definition available to the daemon
  agh agent list

  # Show agents resolved for a workspace
  agh agent list --workspace ~/dev/ai/acme-startup

  # Emit the same list as JSON
  agh agent list -o json

Options

  -h, --help               help for list
      --workspace string   Resolve agents 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 agent list -o json

agh agent info

Show one agent definition

agh agent heartbeat

Inspect and manage agent HEARTBEAT.md files

On this page

agh agent list Examples Options Options inherited from parent commands Output Formats