Skinwalker
nosleepcassette/skinwalker
Textual TUI for creating, previewing and activating Hermes CLI skins, with ASCII logo and hero art
Skinwalker is a Textual-based terminal app for creating, editing, previewing and activating Hermes CLI skins. It works against the real Hermes skin schema and saves skins into the active Hermes home.
What Skinwalker does
Skinwalker reads the real built-in skins from Hermes, edits the real skin schema, saves custom skins into ~/.hermes/skins/ and activates one by updating display.skin in the chosen profile's config.yaml. A terminal-native live preview sits beside a generated YAML preview, and whole-skin YAML can be imported from text or a file and exported to a path.
Editor tabs cover identity, colors, spinner, art and AI. The Art tab generates logos from text with pyfiglet and hero art from an image with Pillow, with controls for brightness, contrast, dithering and more, and exports to .txt or PNG. The spinner tab edits wing pairs, waiting and thinking faces and verbs, with a live animated preview. The AI tab can generate branding, spinner, logo, hero art and skin bundles through Hermes or configured API backends. The repository also includes imagewalker, a standalone image-to-ASCII tool, and the app offers undo, redo and modified-field highlighting.
Key features
- Browses and edits built-in and custom Hermes skins against the real skin schema
- Saves to ~/.hermes/skins/ and activates a skin through display.skin in config.yaml
- Live terminal preview and generated YAML preview, with YAML import and export
- Logo generation with pyfiglet and image-to-ASCII hero art with Pillow
- Palette presets, color editing and a spinner preset shelf with a live animated preview
- Standalone imagewalker tool built on the same rendering stack
When to use it
- Designing a custom Hermes CLI skin with its own logo, palette and spinner
- Converting an image into ASCII hero art for the Hermes terminal
- Switching the active skin of a Hermes profile from a TUI
Who it is for: Hermes Agent users who want to customize the look of the Hermes CLI beyond picking a stock theme.
How it fits with Hermes Agent
Built for Hermes CLI skins: it reads the built-in skins from a local Hermes checkout and writes into the active Hermes home.
Requirements: Python 3.13+ and a local Hermes checkout at ~/.hermes/hermes-agent (override with --hermes-root or HERMES_AGENT_ROOT)
Note: The README describes it as an upgraded working beta, with color workflow, responsive art and async AI work still on the roadmap.
FAQ
What is Skinwalker?
Skinwalker is a terminal user interface for creating, editing, previewing and activating Hermes CLI skins. It covers identity, colors, spinner, art and AI-assisted generation.
What do I need to run Skinwalker?
You need Python 3.13 or newer and a local Hermes checkout at ~/.hermes/hermes-agent. You can point it at a different checkout with --hermes-root or the HERMES_AGENT_ROOT variable.
Is Skinwalker free and open source?
The repository has no license file, so default copyright applies and you should check with the author before reuse.
Similar interfaces for Hermes Agent
All interfacesSelf-hosted dashboard for running a fleet of long-lived AI agents on your own infrastructure
openwarehq freejarvisVoice command deck that runs on its own model or acts as the face of a self-hosted Hermes Agent
lxfu1 memo-agentTerminal AI coding assistant built with TypeScript and Ink, described as a simplified Hermes Agent
angel12 Mercury VoiceNative SwiftUI voice-conversation client for Hermes Agent on macOS and iOS
thefullctx Hermes for TernNative Tern frontend for Hermes Agent that renders the conversation as Markdown, tool rows and subagents
openma-ai BackchatLocal-first desktop workspace for ACP agents including Claude Code, Codex, Gemini CLI and Hermes
Related guides: Connect Hermes agents on several machines with Hermes Desktop · How to install Hermes Agent