Cli reference

CompozyOS RuntimeDoctor

compozy doctor

Run runtime diagnostics

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

compozy doctor

Run runtime diagnostics

compozy doctor [flags]

Examples

  # Run diagnostics
  compozy doctor

  # Return diagnostic items for agents
  compozy doctor -o json

  # Run only provider and MCP diagnostics
  compozy doctor --only provider --only mcp

Options

      --exclude strings   Exclude the named probe ids or categories
  -h, --help              help for doctor
      --only strings      Run only the named probe ids or categories
      --quiet             Omit OK diagnostics

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 doctor -o json

On this page

compozy doctor Examples Options Options inherited from parent commands Output Formats