# Browser Viewer: Hermes Agent plugin

> Live view and human takeover of the browser Hermes drives: stream its tabs to a web page on another device and click, type and scroll yourself to log in, pass 2FA or a CAPTCHA.

Canonical: https://hermeswatcher.com/plugins/browser-viewer  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/browser-viewer  
Last updated in catalog: 2026-11-14

Live view and human takeover of the browser Hermes drives: stream its tabs to a web page on another device and click, type and scroll yourself to log in, pass 2FA or a CAPTCHA.

## Good to know before installing

Starts a detached aiohttp server that listens on explicit IPv4 addresses (loopback plus the Tailscale address if tailscale is installed; never 0.0.0.0), over plain HTTP by default or HTTPS when the user opts in with hermes browser-viewer tls (tailscale cert contacts the Tailscale control plane and Let's Encrypt, and the machine name appears in public Certificate Transparency logs); login links are single-use (10 minutes) and are exchanged for an HttpOnly session cookie (7 days by default, Secure over HTTPS), and the start and link actions return such links to the session transcript; launches Chromium with a persistent profile (cookies and logins) and CDP on 127.0.0.1, which makes its usual background connections; the server and Chromium get a minimal environment, not the Hermes one (proxy settings and desktop-session variables are passed on); runs chromium --version, tailscale ip -4, tailscale status and tailscale cert (HTTPS mode only) and hermes config set|unset browser.cdp_url (the use action changes browser.cdp_url for every session of the profile, and browser_exec then acts with that browser's logins); status and list return each tab's origin and a truncated title to the session transcript; reads /proc, /proc/net/tcp and Chromium builds under the Hermes tools directory; no telemetry from the plugin. Linux only.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install browser-viewer
```

2. Said no? Turn it on later:

```bash
hermes plugins enable browser-viewer
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Web, research & browsing
- Maintained by: vittoriocompagno (Community)
- Needs: No API keys declared
- Adds tools: `browser_viewer`
- Works on: linux
- Requires Hermes: `>=0.23.1`
- Version: 0.1.0
- In the catalog since: 2026-11-14

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/browser-viewer)
- [Source code](https://github.com/vittoriocompagno/hermes-browser-viewer#readme)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt
