Docs Features Agent Hub GitHub Get Started

automagent diff

Compare local agent definition with the published version on the Hub

Usage

$ automagent diff [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)Read from definition
--version <version>Compare against a specific versionLatest

How it works

  1. Reads and parses the local agent definition
  2. Fetches the remote definition from the Hub using the agent’s name and scope
  3. Compares the two YAML representations line by line
  4. Displays a colorized diff (green for additions, red for deletions)

If the agent does not exist in the Hub yet, the CLI prints a message and exits cleanly.

Examples

Compare with latest published version:

$ automagent diff --scope @acme

Compare against a specific version:

$ automagent diff --scope @acme --version 1.0.0

Diff a file at a custom path:

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

Notes

  • The scope must be provided via --scope or present in the local definition. The CLI will error if neither is available.
  • When no differences are found, the CLI prints a confirmation message.

See also