Skip to content

compozy agent instance list

Manage agent instances: list

564 pages in CLI Reference

On this page4

Usage

compozy agent instance list [flags]

Options10

--agentstring
Filter by agent name
--all-profiles
Read across every profile and include owner labels
--all-workspaces
Include every workspace
--cursorstring
Continue from next_cursor
--global
Use the global scope
--help-h
help for list
--limitint
Page size (1-100) (default 50)
--peers
List reachable always-on peers
--statestring
Filter by state
--workspacestring
Workspace ID, name, or path

Inherited options3

--json
Emit JSON output
--output-ostring
Output format: human, json, jsonl, or toon (default "human")
--profilestring
Act as a profile for this command

Output Formats

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy agent instance list -o json