commands:UserCommand
A user-defined command stored in the Platform.
Extends: commands:Command
Scoped to (owner, workspace) pair. Created, updated, and deleted via Platform API.
Properties
commands:alias (required, max 1)
CLI invocation name without leading slash (e.g., 'overdue-tasks', 'custom-command').
Alias must start with lowercase letter, contain only lowercase letters, numbers, and hyphens.
Must be URL-safe: lowercase letters, numbers, hyphens, and colons. Combined with prefix to form full command name (e.g., 'ex:custom-command').
commands:commandId (required, max 1)
Platform-assigned unique identifier for the user command.
Command ID must be a valid UUID string.
commands:createdAt (required, max 1)
Timestamp when the command was created.
Created at must be a dateTime.
commands:description (optional, max 1)
Human-readable description of what the command does.
Description must be a string.
commands:interpretation (optional, max 1)
Guidance for how the agent should interpret and present the command results.
Interpretation must be a string.
Instructions for the agent on how to summarize, format, or act on the RDF results returned by the command script.
commands:owner (required, max 1)
User who created this command.
User command must have exactly one owner (iam:User).
commands:prefix (optional, max 1)
Namespace prefix for the command (e.g., 'ex', 'proj').
Command prefix must be lowercase letters and numbers only.
Combined with alias to form full command name. For matrix commands, typically matches the matrix prefix. Full command is invoked as /prefix:alias.
Inherited from parent class.
commands:script (required, max 1)
CONSTRUCT or DESCRIBE script executed when command is invoked.
Command must have exactly one script.
Must use os:construct or os:describe content. Script has access to ?modifier binding containing natural language text after the command. Can use sub-agents (os:Find, etc.) to interpret the modifier.
commands:updatedAt (required, max 1)
Timestamp when the command was last updated.
Updated at must be a dateTime.
commands:workspace (required, max 1)
Workspace this command belongs to.
User command must have exactly one workspace.
User commands are scoped to (owner, workspace) pairs.