Skip to content

a2a catalog

Register AI Catalogs and find the A2A agents they list.

Catalogs are kept in the store shared with ai-catalog-cli (~/.ai-catalog, or $AI_CATALOG_CACHE_DIR), so a catalog registered with either tool is visible to both. Pass an agent's identifier to --agent-card to talk to it.

These commands are experimental: the store layout is not part of the AI Catalog specification.

a2a catalog <command>

Aliases: catalogs

The global flags apply too.

a2a catalog add

Fetch the AI Catalog at a URL or local path, and the catalogs nested in it, and register it under a name. A URL without a path, or a bare host, gets the well-known path /.well-known/ai-catalog.json.

a2a catalog add <name> <url|path>

a2a catalog list

List registered AI Catalogs

a2a catalog list

a2a catalog remove

Unregister an AI Catalog

a2a catalog remove <name|source>

Aliases: rm

List the A2A agents (entries of type application/a2a-agent-card+json) whose identifier, name, description or tags contain the query, ignoring case. Without a query every agent is listed.

Searches the registered catalogs, or only the one given with --catalog, which may also be the URL of a catalog that is not registered.

a2a catalog search [query]

Examples

a2a catalog search finance
a2a catalog search --catalog corp
a2a send -a <identifier> "hello"

a2a catalog update

Fetch a registered AI Catalog from its source again, or every registered catalog when no name is given.

a2a catalog update [name]