Agent

CompozyOS RuntimeAgent

compozy agent list

List installed agent definitions

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

compozy agent list

List installed agent definitions

compozy agent list [flags]

Examples

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

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

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

Options

  -h, --help               help for list
      --workspace string   Override workspace context (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 Compozy 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:

compozy agent list -o json

compozy agent info

Show one agent definition

compozy agent update

Update an agent definition for future sessions

On this page

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