> ## Documentation Index
> Fetch the complete documentation index at: https://herm.liftaris.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Find and install community eikons from Herm Marketplace

> Browse the public Eikon catalog in Herm, inspect package status, install entries, download source when available, and activate installed avatars.

The Eikon Marketplace is Herm's native browser for the public eikon catalog. It is an install and inspection UI inside the terminal.

Open it with **Alt+5** and the **Marketplace** sub-tab, or type `/marketplace`.

## Browse the catalog

Marketplace loads the catalog and renders entries as cards. Cards show the poster preview, name, author, and current install status.

Select a card to preview it in the sidebar. Press `Space` to toggle the preview state between `idle` and `thinking` when a preview is available.

## Search and refresh

| Key     | Action                                         |
| ------- | ---------------------------------------------- |
| `/`     | Filter catalog entries                         |
| `r`     | Reload the catalog                             |
| `Space` | Toggle preview state                           |
| `Enter` | Open the actions dialog                        |
| `d`     | Uninstall a local installed entry when allowed |

## Install or use an entry

Press `Enter` on a card to open the actions dialog. Available actions depend on the package and local state.

Common actions include:

* **Use:** activate an entry that is already installed.
* **Eikon only:** install the runtime artifact without source media.
* **Eikon + Source:** install the runtime artifact and fetch source media when the package exposes it.
* **Download Source:** fetch source media for an already-installed entry when available.
* **Uninstall:** remove the local installed entry. This only affects your machine — the entry stays in the public registry.
* **Delist from Registry:** open an author-owned pull request that removes the entry from the public Eikon registry. See [Delist from Registry](#delist-from-registry).

Installing an eikon does not automatically activate it. Use the action dialog or Gallery to choose when it becomes active.

<Note>
  **Uninstall** removes files from your local Hermes home. **Delist from Registry** is a separate action that takes the entry down from the public catalog for everyone. They are independent — you can uninstall without delisting, and delisting does not touch your local install.
</Note>

## Delist from Registry

`Delist from Registry` requests removal of an official catalog entry from the public Eikon registry. It is available from the Marketplace actions dialog on official catalog entries, and from the CLI:

```bash theme={null}
herm eikon delist <name|id>
```

### Who can request a delist

Only the GitHub user who authored the original merged `eikons: submit <name>` pull request can delist an entry. Herm looks up the submission PR for the entry, compares its author to your authenticated `gh` user, and refuses the action if they do not match. Non-official entries (anything not served by the public registry host) are not eligible.

### What the PR contains

Herm forks the registry repo under your account, opens a branch named `delist/<name>`, and pushes a single commit titled `eikons: delist <name>` that:

* removes the entry from `eikons/index.json`
* removes the entry's files under `eikons/<name>/` and `packages/<namespace>/<name>/`

The PR is opened against the registry's `main` branch from your fork. Herm prints the PR URL when the request succeeds.

### Auto-merge

The Eikon registry runs an `auto-delist` workflow on every PR whose title starts with `eikons: delist `. It re-runs the same validation server-side:

* the PR author matches the original submit-PR author
* only the target entry's files are removed
* `eikons/index.json` is updated to remove exactly that entry and nothing else

If validation passes, the workflow squash-merges the PR on the validated head commit. If anything fails, the PR stays open with the validation error and the registry maintainers can review it manually.

After the merge propagates, the entry disappears from the public catalog. Existing local installs are unaffected — use **Uninstall** (or `herm eikon remove <name>`) to remove your local copy.

## Catalog trust and compatibility

Marketplace shows package status from catalog metadata and local install state. Treat status and digest fields as integrity hints. They help you inspect what package is installed and whether source media is available.

## Browser gallery boundary

[eikon.liftaris.dev](https://eikon.liftaris.dev) is a discovery gallery. It previews catalog entries and gives install instructions. Herm owns the native Marketplace install, source-download, activation, and deletion flows.

## Related docs

* [Eikon overview](/eikon/overview)
* [Gallery](/eikon/gallery)
* [Studio](/eikon/studio)