Hermes Status Widget: app and UI for Hermes Agent

Read-only macOS menu bar and desktop widget showing Hermes Agent status, sessions and token use

What Hermes Status Widget does

Hermes Status Widget is a Swift app that reads the local Hermes state and shows it in two places. The menu bar dropdown carries the detailed view, and the desktop widget carries a compact one. It reports whether Hermes is online, how long the agent has served today, up to three current or recently active sessions, tokens used in the last 24 hours and the split between models.

The main app stays in the menu bar and reads local state every 30 seconds from ~/.hermes/gateway_state.json, gateway.pid and state.db, and runs ps for the gateway's memory use. The WidgetKit widget reads a snapshot that the main app writes. It does not call the Hermes dashboard and does not write to Hermes' database or configuration. Sessions come from the sessions and messages tables, with in-progress ones listed first. A non-default Hermes directory can be set with the HERMES_HOME environment variable. The README is written in Chinese.

Key features

Online or offline state of the local Hermes Agent
Time the agent has served today
Up to three active or recent sessions, in-progress ones first
Tokens used in the last 24 hours, broken down per model
Detailed menu bar dropdown and compact WidgetKit desktop widget
Read-only access to Hermes files

When to use it

Glancing at the menu bar to confirm Hermes is running on a Mac
Keeping a desktop widget with the last day's token use per model
Checking which sessions are active without opening a terminal or dashboard

Who it is for: Mac users who run Hermes Agent locally and want a quick status readout without opening a dashboard.

How it fits with Hermes Agent

Built for Hermes Agent; it reads the gateway state files and state.db under ~/.hermes and never modifies them.

How to install Hermes Status Widget

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

chmod +x Scripts/build-app.sh
Scripts/build-app.sh
cp -R "dist/Hermes Status Widget.app" /Applications/
open "/Applications/Hermes Status Widget.app"

Requirements: macOS, and Hermes Agent running locally with state files in ~/.hermes

Note: macOS may show an unverified-developer warning on first open; the README says to allow the app under System Settings, Privacy and Security.

FAQ

What is Hermes Status Widget?

Hermes Status Widget is a read-only macOS app that shows Hermes Agent's local status in the menu bar and as a desktop widget. It covers online state, active sessions and token use per model over the last 24 hours.

Does Hermes Status Widget work with Hermes Agent?

Yes, it is made for Hermes Agent. It reads gateway_state.json, gateway.pid and state.db in ~/.hermes and does not write to them.

How do I install Hermes Status Widget?

Download Hermes-Status-Widget-0.4.3.pkg from the repository's Releases page, double-click it, then open Hermes Status Widget from Applications. You can also build from source with Scripts/build-app.sh.