Hermes Control Interface: app and UI for Hermes Agent

Self-hosted password-protected web dashboard for Hermes Agent with chat, terminals, files, cron and MCP

What Hermes Control Interface does

Hermes Control Interface is a Node.js and Express app with a Vanilla JS and Vite front end, using WebSocket, xterm.js, Chart.js and better-sqlite3. Its pages include Home, Chat, Workspace, Agents, Office, Monitor, Usage, Logs, Skills, Files, MCP and Maintenance. Chat streams in real time over a WebSocket gateway API with a profile switcher and tool call cards.

The Office page is a three-panel swarm monitor with an agent health grid, an eight-lane kanban pipeline and a live feed from gateway logs. The MCP page starts, stops and restarts MCP servers, tails logs and edits config. For teams, 20 permissions are split across three roles, and profile-based access isolation can restrict a user to specific agent profiles. It is installable as a PWA, and the docs cover production setup with nginx and systemd.

Key features

Real-time chat with multi-profile switching, tool call cards and session resume
Browser terminal and file explorer for the server
Office swarm monitor with agent health, kanban lanes and a live feed
Usage page with token analytics, daily trends, cost projections and budget alerts
MCP manager to start, stop and restart servers, tail logs and edit config
Role-based access with 20 permissions across 3 roles and per-profile isolation

When to use it

Managing several Hermes Agent profiles from one browser tab
Watching token spend and setting budget alerts
Giving a team restricted access to only the agent profiles they own

Who it is for: Hermes Agent operators who run agents on a server and want a browser dashboard instead of the terminal alone.

How it fits with Hermes Agent

Built for the Hermes Agent stack, managing its profiles, gateway lifecycle, skills, cron and MCP servers.

How to install Hermes Control Interface

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/xaspx/hermes-control-interface.git
cd hermes-control-interface
cp .env.example .env
npm install && npm run build

Requirements: Node.js and npm; HERMES_CONTROL_PASSWORD and HERMES_CONTROL_SECRET set in .env

FAQ

What is Hermes Control Interface?

Hermes Control Interface is a self-hosted web dashboard for the Hermes Agent stack. It manages agents, chat, terminals, files, cron, token analytics, MCP servers and swarm pipelines behind a password gate.

Does Hermes Control Interface work with Hermes Agent?

Yes, it is built for the Hermes Agent stack and manages profiles, gateways, skills, cron and MCP servers. Its topics on GitHub are ai-agents and hermes-agent.

How do I install Hermes Control Interface?

Clone the repository, copy .env.example to .env and set HERMES_CONTROL_PASSWORD and HERMES_CONTROL_SECRET. Then run npm install && npm run build and start it with node server.js, which serves the dashboard at http://localhost:10274.