Runtime

agents

Manage agent manifests and registry.

Synopsis

Shell

$ phrony agents <subcommand> [args] [flags]

Description

Agent lifecycle commands: validate and publish manifests locally or to the runtime, inspect versions, deploy activations, and manage registry state. All subcommands except validate and diff require a running runtime.

Subcommand	Page	Summary
`agents ls`	—	List agents in the runtime
`agents archive`	—	Archive an agent (deprecate all versions)
`agents validate`	`validate`	Validate an agent manifest locally
`agents diff`	`diff`	Diff local manifest against a published version
`agents publish`	`publish`	Publish an immutable agent version
`agents versions`	`versions`	List published versions
`agents inspect`	`inspect`	Metadata for a published version
`agents deprecate`	`deprecate`	Mark a version as not runnable
`agents retire`	`retire`	Retire a published version
`agents deploy`	`deploy`	Activate a published version for sessions
`agents active`	`active`	Show the active deployed version
`agents history`	`history`	Deployment activation history

rollback stays at the top level for quick access.

`agents ls`

List agents.

Shell

$ phrony agents ls [flags]

Flags

Flag	Short	Description
`--namespace`	`-n`	Filter by namespace

Example

Shell

$ phrony agents ls
$ phrony agents ls -n demo

Output

Table columns: ID, NAMESPACE, NAME, OWNER, STATUS (active or archived).

`agents archive`

Archive an agent and deprecate all of its versions.

Shell

$ phrony agents archive AGENT

AGENT is namespace/name.

Example

Shell

$ phrony agents archive demo/echo-agent

Output

Text

archived agent demo/echo-agent (all versions deprecated)

Archived agents cannot be deployed or run.

Up next

validate

Check manifests before publish.