automagent versions
List published versions of an agent on the Automagent Hub
Usage
$ automagent versions <scope> <name> [options]
Both <scope> and <name> are required.
Options
| Flag | Description | Default |
|---|---|---|
--hub-url <url> | Hub URL | https://hub.automagent.dev |
--insecure | Allow insecure HTTP connections | Off |
--json | Output raw JSON | Off |
Examples
List all versions:
$ automagent versions @acme support-agent
Output as JSON:
$ automagent versions @acme support-agent --json
Output
The default output shows version numbers and creation dates:
Versions of @acme/support-agent
1.2.0 3/10/2026
1.1.0 2/15/2026
1.0.0 1/20/2026
With --json, the output is a JSON object suitable for scripting:
{
"versions": [
{ "version": "1.2.0", "createdAt": "2026-03-10T12:00:00Z" },
{ "version": "1.1.0", "createdAt": "2026-02-15T09:30:00Z" },
{ "version": "1.0.0", "createdAt": "2026-01-20T14:00:00Z" }
]
}
Notes
- If the agent is not found, the CLI prints an error and exits with code 1.
- Authentication is not required to list versions.
See also
- automagent pull — Download a specific version
- automagent diff — Compare local changes against a published version
- automagent unpublish — Remove an agent from the Hub