automagent push

Publish an agent definition to the Automagent Hub

Usage

$ automagent push [path] [options]

The [path] argument defaults to ./agent.yaml.

Options

FlagDescriptionDefault
--hub-url <url>Hub URLhttp://localhost:3000
--scope <scope>Agent scope (e.g. @acme)@local

How it works

  1. Reads and parses the local agent.yaml
  2. Validates the definition against the JSON Schema
  3. Sends a PUT request to the Hub API with the agent name, version, definition, and tags
  4. If you are logged in (via automagent login), authentication headers are included automatically

If you are not logged in, the CLI prints a warning but still attempts the push. The Hub may reject unauthenticated requests depending on its configuration.

Examples

Push to the default local hub:

$ automagent push

Push with a team scope:

$ automagent push --scope @myteam

Push a file from a different path:

$ automagent push ./agents/support.yaml --scope @acme

Push to a remote hub:

$ automagent push --hub-url https://hub.automagent.dev --scope @acme

See also