automagent pull

Download an agent definition from the Automagent Hub

Usage

$ automagent pull <ref> [options]

The <ref> argument is required and uses the format @scope/name or @scope/name:version.

Options

Reference format

Agent references follow the pattern @scope/name with an optional :version suffix:

@acme/support-agent          # Latest version
@acme/support-agent:1.2.0    # Specific version

Examples

Pull the latest version:

$ automagent pull @acme/support-agent

Pull a specific version:

$ automagent pull @acme/support-agent:1.0.0

Save to a custom path:

$ automagent pull @acme/support-agent -o agents/support.yaml

Overwrite an existing file:

$ automagent pull @acme/support-agent --force

Notes

• The output file includes a # yaml-language-server schema directive for editor autocomplete.
• The command will not overwrite an existing file unless --force is passed.
• If the agent is not found, the CLI prints an error and exits with code 1.

See also

• automagent push — Publish agents to the Hub
• automagent search — Find agents on the Hub