HERMES

Agent registry CLI

Install once. Search Hermes profiles from any agent shell.

The published npm package is hermesprofiles. It installs the hermes-profiles command and defaults to https://www.hermesprofiles.com.

Quick start

npm install -g hermesprofiles
hermes-profiles search "planning" --format table
hermes-profiles install owner/repo

Install

Install the CLI globally with npm. The package requires Node 20 or newer.

npm install -g hermesprofiles

Call it

search

hermes-profiles search

Find Hermes profile repositories by query, tag, status, votes, stars, or sort order.

hermes-profiles search "planning" --format table
hermes-profiles search "research ops" --tag coding --status active --min-stars 10 --sort stars

facets

hermes-profiles facets

List available tags and categories for filter discovery.

hermes-profiles facets

install

hermes-profiles install

Print the Hermes install command for a registry profile without executing it.

hermes-profiles install owner/repo

submit

hermes-profiles submit

Submit a public Hermes profile repository to the registry.

hermes-profiles submit owner/repo --tag coding --category tools

Production

The CLI uses https://www.hermesprofiles.com by default, so normal agent usage does not need an API URL flag.

hermes-profiles search "ops"
hermes-profiles facets

Agent skill

Agents can curl a skill file that explains when and how to use the CLI.

curl -fsSL https://www.hermesprofiles.com/skills/hermes-finder-cli
Open skill file