Theme Lab: plugin for Hermes Agent

Hermes desktop plugin that turns any image into light and dark themes with a 16-color terminal palette

What Theme Lab does

Theme Lab ships as a single plain ES module plugin whose id is theme-forge. You paste, drag in or browse for an image, and it extracts dominant colors with median-cut palette extraction and maps them onto every DesktopTheme token. The swatch in slot one becomes the background, slot two becomes the text color for the interface and terminal, and the first chromatic swatch becomes the accent, used exactly as placed with no blending.

Each forge produces light and dark variants and a full 16-slot ANSI terminal palette. Themes register through THEMES_AREA, so they appear in Settings, Appearance, in the command palette search and in the /skin command. You can drag swatches to change priority, open a color picker with an eyedropper, rename or delete themes, and reforge from the saved source image. Themes persist in plugin storage with schema migration. The plugin has no dependencies, no build step and needs no API keys.

Key features

Image to theme from paste, drag-and-drop or file browse
Median-cut palette extraction mapped to every DesktopTheme token
Light and dark variants with a full 16-slot ANSI terminal palette
Swatch reordering and a color picker with HSV wheel, sliders, hex field and screen eyedropper
Contrast-safe derivation for secondary tokens such as muted text
Standalone Node test harness with 74 checks for the color math

When to use it

Matching the Hermes desktop app to a brand screenshot or a wallpaper
Creating a light and dark pair plus terminal colors from one source image
Adjusting a generated theme by swapping swatches and reforging it

Who it is for: Hermes desktop app users who want to restyle the interface and terminal from an image they already have.

How it fits with Hermes Agent

Built for the Hermes desktop app as a desktop plugin copied into ~/.hermes/desktop-plugins/, using the @hermes/plugin-sdk.

How to install Theme Lab

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

git clone https://github.com/0-CYBERDYNE-SYSTEMS-0/theme-lab.git
cp -r theme-lab/theme-forge ~/.hermes/desktop-plugins/

Requirements: Hermes desktop app (hermes desktop) on macOS, Windows or Linux; no dependencies or API keys

FAQ

What is Theme Lab?

Theme Lab is a plugin for the Hermes desktop app that generates light and dark themes, including a 16-color terminal palette, from any image. The themes install live and show up in the Appearance settings.

Does Theme Lab work with Hermes Agent?

Yes, it is a desktop plugin for the Hermes Agent desktop app. The app watches ~/.hermes/desktop-plugins/ and hot-loads the plugin within seconds, or you can run Reload desktop plugins from the command palette.

Is Theme Lab free and open source?

Yes. Theme Lab is released under the MIT license and the source is public on GitHub.