Hermes Browser Extension

Browser-native side panel for Hermes Agent — connect active web context through a local gateway, Hermes Cloud, or a self-hosted remote gateway.

Created by Jon Komet (@abundantbeing). Community extension for Hermes Agent by Nous Research.

What it is

Hermes Browser Extension is not a browser chatbot. It is a Chrome/Edge/Chromium side panel for the real Hermes Agent runtime. Choose a local gateway, attach to a signed-in Hermes Cloud agent tab, or connect to a self-hosted remote API/dashboard. Local and remote API connections can use the models, tools, skills, sessions, memory, and MCP servers already configured in Hermes; Cloud and dashboard-ticket connections are intentionally Chat-only.

This repo is specifically for the Hermes Browser Extension: the Chrome/Edge/Chromium side-panel integration for Hermes Agent.

Visual tour

Hermes Web

Open the extension's full view for canonical Hermes sessions, model/runtime control, rich messages, generated media, and accurate session context telemetry in a browser-native workspace.

Hermes Web Alpha currently uses token-backed Local or Remote API connections. Hermes Cloud Preview and ticketed remote-dashboard transports remain Chat-only in the side panel; live full-view dashboard handoff is not shipped yet.

Highlights

• Adds Hermes Web Alpha, a full-page browser workspace for canonical Hermes sessions with a session rail, user-right/Hermes-left messages, safe rich Markdown, model/runtime controls, tools, skills, attachments, voice, active-run steering, generated media, and a context/activity/diagnostics inspector.
• Chrome/Edge/Chromium MV3 side panel powered by the Side Panel API.
• Matches Hermes Desktop's three connection choices: Local gateway, Hermes Cloud, and Remote gateway.
• Connects to a configurable local or self-hosted remote Hermes API server. Default: http://127.0.0.1:8642.
• Uses Trusted Dashboard Attach for Hermes Cloud: an explicitly selected, signed-in HTTPS agent tab mints a short-lived, single-use WebSocket ticket. Tickets stay memory-only and Cloud remains Chat-only.
• Supports the same ticketed WebSocket path for a self-hosted remote dashboard when Remote gateway is selected with no API key.
• Auto-syncs connected Hermes providers/models, profiles, skills, sessions, and capabilities.
• Keeps runtime plugins available in the same Hermes session. For example, a connected social or messaging plugin can add account, post, and trend context while the extension supplies browser-page context.
• Shows a Hermes compatibility panel so older gateways degrade into explicit fallback/manual modes instead of broken route errors.
• Adds Copy Diagnostics for v0.1.11 support reports: browser family, version/build, extension origin, gateway origin, capability flags, context mode, selected model/provider, and last visible error with tokens/page content stripped.
• Adds an optional Hermes Browser Companion Plugin that passively caches sanitized Browser Context Protocol metadata for Hermes tools/hooks without browser control, network calls, or API-server routes.
• Adds /meta / /metadata / /head for truthful captured-page metadata analysis: it reports only what the Browser context actually contains and explicitly calls out metadata classes that were not captured.
• Adds session controls for Browser work: create/switch sessions, copy session IDs, rename sessions, smart first-message titles, and compact on-brand session actions.
• Adds Browser-scoped model control: Browser model choices and per-session bindings stay inside the extension and do not mutate Hermes global defaults.
• Sends active tab/browser context into a persisted Hermes session, or switches to Chat only when you do not want browser context attached.
• Adds a composer-header context menu for Chat only, following the active tab, pinning a specific tab, and choosing which open tabs appear in the prompt.
• Opens as a tab-attached side panel by default, with a setting to keep the panel global across tabs.
• Opens with a keyboard shortcut (Alt+H by default, customizable at chrome://extensions/shortcuts).
• Keeps pinned-tab conversations isolated with per-tab local history and Hermes session bindings.
• Adds quick commands for common browser-context work, including /summarize, /explain, /rewrite, /tabs, and /action-items.
• Adds a collapsible “What Hermes saw” receipt after each sent turn for transparent context/debugging.
• Shows a live Tool Activity Strip while Hermes streams, so tool calls appear as structured runtime activity instead of raw [tool] markdown appended into answers.
• Classifies upstream Hermes runtime/tool exceptions as connected-with-warning diagnostics when the gateway is reachable, including the known Python NoneType/int() traceback class.
• Captures active tab title/URL, open tabs, selected text, readable page text, metadata, headings, forms, links, and buttons where available.
• Supports voice dictation through Hermes audio transcription when available, with Browser speech fallback when the connected runtime does not expose STT.
• Wraps webpage text as untrusted context before sending it to Hermes.
• Streams Hermes responses and falls back to non-streaming chat when needed.
• Includes Desktop-style appearance settings with Light/Dark/System mode and nine themes: Nous, Midnight, Ember, Mono, Cyberpunk, Slate, Senter Space, Aphrodite, and Solstice.
• Adds generated-image reveal animation plus a lightbox with zoom, reset, open, and explicit download controls.
• Omits credential-bearing tab URLs from prompt-facing context, including decoded/nested query or hash parameters and common signed-URL credentials/signatures.
• Includes a localhost agent picker for switching between trusted local Hermes API gateway ports.
• No debugger, nativeMessaging, click/type/form-submit, cookies, history, bookmarks, or browser-control permissions in v0.1. The downloads permission is used only when the user explicitly saves generated images or artifacts.

Requirements

• Hermes Agent installed and working.
• For Local or Remote API mode: Hermes Gateway/API server enabled locally or on a reachable remote machine. Hermes Cloud instead requires a signed-in HTTPS agent tab.
• Node.js 20+.
• Chrome, Edge, Brave, Comet, or another Chromium browser with Side Panel API support (Chrome 114+ baseline). Firefox is available as a preview package through npm run build:firefox.

v0.1.11 compatibility matrix