Sahil-SS9

hermes-Custom-CLI-Themes

YAML-based visual skins for customizing the Hermes Agent CLI with themed palettes, spinners, and ASCII banners.

11 starsHTMLMIT

Repository last updated May 25, 2026

Overview

Hermes Custom CLI Themes is a collection of visual skins that personalize the Hermes Agent terminal interface. Each theme is defined in a single YAML file configuring color palettes, spinners, branding, and ASCII banner art. Users can apply skins by placing them in ~/.hermes/skins/ and updating the config or using the in-app /skin command.

The pack includes a dozen themed presets—from tactical and sci-fi aesthetics to minimalist investigator styles—each designed to make the terminal feel like a specific environment rather than just a color scheme. A one-liner install script automates skin deployment, and the project provides a template for creating custom skins.

Highlights

  • YAML-based skins for terminal palettes and ASCII branding
  • One-liner script for automated skin installation
  • Supports custom extended keys for advanced UI styling
  • Includes 12 themed presets with distinct aesthetics
  • Template and validation tools for creating new skins

Features

YAML Skin Format

Each skin is a single YAML file defining color palette, spinner, branding, and ASCII banner art.

Easy Installation

Use a one-liner curl command or manually place skins in ~/.hermes/skins/ and set via config or /skin command.

Extended Key Support

Optional extended keys like response_text and reasoning_border allow finer control over UI elements.

Rich Console Markup

Banner fields support per-character gradients and rich markup for visually striking displays.

Validation & CI

A Python validation script and GitHub Actions workflow ensure skin YAMLs are correct on every push.

Installation

Commands are reproduced exactly as published by the project maintainers. Always check the upstream repository for the current instructions.

curl -fsSL https://raw.githubusercontent.com/Sahil-SS9/hermes-Custom-CLI-Themes/main/scripts/install.sh | bash -s <skin>
mkdir -p ~/.hermes/skins
curl -fsSL https://raw.githubusercontent.com/Sahil-SS9/hermes-Custom-CLI-Themes/main/skins/kensei.yaml \
  -o ~/.hermes/skins/kensei.yaml
display:
  skin: kensei

Requirements

  • Hermes Agent installed and configured
  • Python 3 for running validation scripts (optional)

How it's built

The repository is organized with skins in skins/, scripts in scripts/, and documentation in docs/. Each skin is a standalone YAML file that overrides selected keys from the default Hermes skin; missing keys inherit defaults. The schema supports 28 standard color keys and 6 optional extended keys for advanced styling.

Hermes loads skins from ~/.hermes/skins/ at startup. The scripts/install.sh script automates download and placement. Validation is performed by scripts/validate_skins.py and runs in CI via .github/workflows/validate.yml. The project is licensed under MIT.

Source

This summary was written for Neura Market from the project's own repository. Install commands, identifiers and licence details are reproduced unchanged. The Sahil-SS9/hermes-Custom-CLI-Themes repository is the authoritative source and the place to file issues or contribute.

Category: Developer Tools · Licensed under MIT

Related Hermes plugins