Hermes for Stream Deck

Put your AI agents on physical buttons.

Hermes for Stream Deck gives Hermes Agent a small control surface: check whether your agents are working, and fire a safe action without opening a browser.

Download plugin →View source

Requires Elgato Stream Deck software and a running Hermes Agent dashboard. Control actions need the companion bridge.

GW OKidle · 2

Agentsworking

Dashopen

Promptrun

Cron ✓backup

Cmdstatus

What it does

A small operating panel for Hermes Agent

The plugin is useful when Hermes is running in the background and you want a quick answer or a safe preset action, not another browser tab.

●

Status key

Polls the Hermes dashboard and shows gateway up/down, busy/idle, and active counts.

≋

Sessions rollup

Shows whether recent sessions are working, idle, or likely waiting for you.

↗

Open dashboard

One button opens your Hermes dashboard for the full conversation and job view.

▶

Saved prompts

Run a configured Hermes prompt from a key and optionally open the dashboard afterward.

✓

Cron triggers

Run a scheduled Hermes cron job now by id or name and report succeeded, failed, or queued.

⌘

Command presets

Run a fixed allowlist of safe status commands. The plugin does not send arbitrary shell commands.

Setup

Start with the status key, then add the bridge

Status and dashboard buttons can talk directly to Hermes. Prompts, sessions, cron, and command presets use a small token-protected bridge that runs next to Hermes.

1. Install the Stream Deck plugin

Download the plugin, double-click it on the computer running Stream Deck, then drag Hermes Status onto a key.

Dashboard URLhttp://YOUR-HERMES-HOST:9119

On macOS, grant Stream Deck Local Network permission if Hermes runs on another machine.

2. Install the companion bridge for controls

Run this on the machine where Hermes Agent runs:

git clone https://github.com/thefotes/hermes-streamdeck-plugin.git
cd hermes-streamdeck-plugin
pipx install ./bridge
hermes-streamdeck-bridge setup --lan

The setup command writes config, creates a token, installs or repairs the background service when your host supports systemd or launchd, checks the bridge, and prints the Dashboard URL, Bridge URL, and Bridge Token to paste into Stream Deck.

3. Check the path before you trust buttons

The bridge includes a command to print the token any time, plus a doctor command for common failure points: Hermes CLI, dashboard status, token config, and local bridge health.

hermes-streamdeck-bridge print-settings   # token + URLs for Stream Deck
hermes-streamdeck-bridge doctor

Security model

Control stays local to your Hermes host

The plugin stores connection settings in Stream Deck. The bridge runs on your Hermes machine, uses bearer-token auth, and exposes a narrow API: health/status, saved prompt execution, cron run by matched job id/name, and allowlisted command presets.

Do not expose the bridge directly to the public internet.
Bind to localhost unless the Stream Deck computer is on another trusted LAN machine.
Use Tailscale, VPN, TLS, or a proper tunnel for remote access.
Use saved prompts and cron buttons like any automation with side effects: label them clearly and test small.

Roadmap

What would make this a paid product?

The release proves the control surface. The next work is reducing setup friction: a signed companion app, guided pairing, richer troubleshooting, multi-host profiles, Stream Deck+ layouts, and a runbook library for safe agent operations.

Download plugin Report an issue

Hermes for Stream Deck is an independent third-party plugin and is not affiliated with or endorsed by Nous Research.