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.

New in v0.2.0: Hermes Assist

Hermes Assist adds a compact, site-aware drafting panel beside supported text composers. It recognizes 31 writing environments and adapts its primary action to the surface—such as Draft a reply, Draft a post, or Draft a message—while preserving useful site-specific actions.

Every model-backed action runs through the connected Hermes Agent. When the gateway advertises per-session model locking, Hermes Assist sends the exact selected provider/model and fails closed if Hermes does not acknowledge it. Released gateways without that contract use the active model configured in Hermes Agent and receive no unsupported override fields. Results are reviewed before use. Safe plain-text composers can apply a draft only after an explicit user action; framework-owned structured editors default to preview/copy. Hermes Assist never clicks Send/Post/Submit, navigates, purchases, or operates the page autonomously.

Private surfaces use per-site context controls and conservative defaults. Browser context remains bounded, redacted, labeled as untrusted, and visible to the user before it is sent.

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.2.0 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, cookies, history, bookmarks, checkout, navigation, or autonomous browser-control permissions in v0.2.0. The downloads permission is used only when the user explicitly saves generated images or artifacts. Hermes Assist can place a reviewed draft into a supported focused composer only after an explicit user action and never submits it.

Requirements

• Hermes Agent installed and working.
• For Local or Remote API mode: Hermes Gateway/API se