ulu definitions
Workflow definition management (registry API). Create, publish, and manage agent, command, workflow, and pipeline definitions.
9 commands
definitions list
List definitions with filtering and search.
Options
-t, --type <type>Filter by type
agentcommandworkflowpipeline-s, --status <status>Filter by status
draftpublisheddeprecatedarchived-d, --domain <domain>Filter by domain
-v, --visibility <visibility>Filter by visibility
publicprivate-l, --limit <number>Limit results
Default:50-o, --offset <number>Offset for pagination
Default:0--search <query>Search by name or description
ulu definitions list# List all published agents
ulu definitions list --type agent --status published
# Search agents by name
ulu def list --search "security" --type agentdefinitions get
Get a definition. Defaults to latest published version.
Arguments
typerequiredDefinition type (agent, command, workflow, pipeline)
namerequiredDefinition name
versionoptionalSpecific version (optional)
Options
--yamlOutput raw YAML
--renderedOutput rendered markdown only
--include-runtimeInclude runtime markdown
--render-profile <profile>Render profile for agent definitions
coreuluops-fullulu definitions get <type> <name> [version]# Get YAML source of a specific version
ulu def get agent code-validator 1.0.0 --yaml
# Get rendered markdown for latest version
ulu def get agent code-validator --rendereddefinitions create
Create a new definition (draft status).
Arguments
typerequiredDefinition type
namerequiredDefinition name
Options
-f, --file <path>Path to YAML file
--visibility <visibility>Visibility
publicprivateprivateulu definitions create <type> <name>definitions update
Update a definition. Use --change-type to create a new version from a published one.
Arguments
typerequiredDefinition type
namerequiredDefinition name
versionrequiredVersion to update
Options
-f, --file <path>Path to YAML file
--visibility <visibility>Visibility
publicprivate--display-name <name>Display name
--description <desc>Description
--change-type <changeType>Version bump type (creates new version from published)
majorminorpatchulu definitions update <type> <name> <version>definitions publish
Publish a definition.
Arguments
typerequiredDefinition type
namerequiredDefinition name
versionrequiredVersion to publish
ulu definitions publish <type> <name> <version># Publish a draft definition
ulu def publish agent my-agent 1.0.0definitions deprecate
Deprecate a published definition.
Arguments
typerequiredDefinition type
namerequiredDefinition name
versionrequiredVersion to deprecate
Options
-r, --reason <reason>Deprecation reason
--successor <ref>Successor definition reference
ulu definitions deprecate <type> <name> <version># Deprecate with successor
ulu def deprecate agent old-agent 1.0.0 --reason "Replaced by new-agent" --successor new-agent@2.0.0definitions validate
Validate YAML without creating a definition. Type is auto-detected from filename (e.g., *.agent.yaml).
Arguments
typeoptionalDefinition type (auto-detected from filename if omitted)
Options
-f, --file <path>Path to YAML file
ulu definitions validate [type] --file <path># Validate with auto-detected type
ulu def validate --file my-agent.agent.yaml
# Validate with explicit type
ulu def validate agent --file my-agent.yamldefinitions render
Render YAML as markdown preview. Type is auto-detected from filename (e.g., *.agent.yaml).
Arguments
typeoptionalDefinition type (auto-detected from filename if omitted)
Options
-f, --file <path>Path to YAML file
--render-profile <profile>Render profile for agent definitions
coreuluops-fullulu definitions render [type] --file <path># Render with auto-detected type
ulu def render --file my-agent.agent.yaml
# Render with explicit type
ulu def render agent --file my-agent.yamldefinitions delete
Delete a draft definition.
Arguments
typerequiredDefinition type
namerequiredDefinition name
versionrequiredVersion to delete
Options
-y, --yesSkip confirmation prompt
ulu definitions delete <type> <name> <version>