Agent
compozy agent create
Create a global or workspace-local agent definition
- Audience
- Operators running durable agent work
- Focus
- Agent guidance shaped for scanability, day-two clarity, and operator context.
compozy agent create
Create a global or workspace-local agent definition
Synopsis
Create a global or workspace-local agent definition through a running Compozy daemon.
compozy agent create <name> [flags]Examples
compozy agent create pricing_strategist \
--workspace ~/dev/ad8 \
--provider claude \
--model claude-sonnet-5 \
--reasoning-effort max \
--prompt "You own pricing strategy." \
-o jsonOptions
--category stringArray Agent category path segment (repeatable)
--command string Optional provider command override
--deny-tool stringArray Denied tool pattern (repeatable)
--disable-skill stringArray Disabled skill name (repeatable)
-h, --help help for create
--model string Optional provider model
--permissions string Optional permission mode
--prompt string Agent system prompt body
--prompt-file string Read the agent system prompt body from a file
--provider string Provider name for sessions using this agent
--reasoning-effort string Optional default reasoning effort
--tool stringArray Allowed tool pattern (repeatable)
--toolset stringArray Allowed toolset reference (repeatable)
--workspace string Override workspace binding (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:
humanfor interactive terminal usejsonfor scripts and other machine-readable consumersjsonlfor wait or streaming commands that emit one JSON record per linetoonfor compact agent-readable summaries
Example:
compozy agent create <name> -o json