---
name: hermes-finder-cli
description: Use the Hermes Finder CLI to search, inspect, install, and submit public Hermes profile repositories from an agent shell.
---

# Hermes Finder CLI

Use this skill when an agent needs to discover Hermes profile repositories, print an install command, list registry facets, or submit a public Hermes profile repository.

## Install

The npm package is `hermesprofiles`. It installs the `hermes-profiles` executable and a compatibility alias named `hermes-finder`.

```bash
npm install -g hermesprofiles
```

The CLI requires Node 20 or newer.

## Registry Target

The CLI defaults to production:

```text
https://www.hermesprofiles.com
```

Normal agent usage does not need an API URL flag.

## Commands

Search the registry:

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

List tags and categories:

```bash
hermes-profiles facets
```

Print the Hermes install command for a profile without executing it:

```bash
hermes-profiles install owner/repo
```

Submit a public Hermes profile repository:

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

## Agent Workflow

1. Run `hermes-profiles search "<query>" --format table` to discover candidate profiles.
2. Run `hermes-profiles install owner/repo` to print the exact Hermes install command.
3. Confirm the command matches the repository the user wants before running any install command.