Local companions

A small program on your computer, at the same version as its extension.

Three of the extensions talk to a companion that listens on 127.0.0.1 only, pairs once with a code, and never contacts Corsen AI. Your browser updates an extension by itself; you update the companion.

Hermes Connector

Match the companion to the version Chrome shows.

Open chrome://extensions and read the number under Hermes Connector. Install the companion with that number.

Chrome showsInstallProtocol · portWhen
0.2.6 CurrentCompanion 0.2.65 · 8767Current. Sessions are listed through the companion, so the side panel works with current Hermes releases whether or not a Web dashboard runs.
0.2.4Companion 0.2.45 · 8767Only while Chrome still shows 0.2.4.
0.2.3Companion 0.2.34 · 8766Only while Chrome still shows 0.2.3.
0.2.2Companion 0.2.24 · 8766Only while Chrome still shows 0.2.2.
0.2.1Companion 0.2.14 · 8766Only while Chrome shows 0.2.1; update from the store when you can.
0.2.0Companion 0.2.03 · 8765Only while Chrome shows 0.2.0.

Do not mix versions. Update the extension first, then install the companion with the same number. Until they match, the side panel shows an update notice and the toolbar icon carries a badge.

Windows

Unzip the companion and double-click Install Hermes Connector.cmd, or run .\install.ps1 in PowerShell. Copy the pairing code it prints.

macOS

Unzip the companion, open Terminal in that folder and run:

./install.sh

Copy the pairing code it prints.

Linux

Unzip the companion, open a terminal in that folder and run:

./install.sh

Copy the pairing code it prints.

  1. Restart Hermes completely. Fully quit and reopen Hermes Desktop, or restart every running Hermes dashboard, gateway and chat. Rerun the installer after creating a new named Hermes profile.

  2. Pair once. Open the side panel, enter the pairing code shown locally, select the Hermes profile and session, and attach only the tabs it may control.

Quick checks when the panel says “offline”

  • The number in chrome://extensions equals the companion you installed.
  • Hermes was fully restarted after the install (quit, not just closed).
  • The default port for that version is free: 8767 for 0.2.4 and later, 8766 for 0.2.1 to 0.2.3, 8765 for 0.2.0.
  • The pairing code was entered after the last install; rerun the installer to show it again.

Hermes Connector page · All releases

DeepSeek Harness Connector

A DeepSeek Harness plugin, added with one command.

Requires DeepSeek Harness, Node.js 22.19+ (or 24 and later) and pnpm on your PATH. The side panel shows these commands for your version, with a Copy button.

  1. Install the companion into a DeepSeek Harness profile:

    dsh plugin --profile web add https://github.com/CorsenAI/deepseek-harness-connector/releases/download/v0.1.0/corsen-ai-dsh-browser-connector-0.1.0.tgz
  2. Start DeepSeek Harness (dsh web, or any profile the connector is installed in). The connector starts its local broker on 127.0.0.1:8781 by itself. Print the pairing code:

    dsh plugin --profile web exec dsh-connector-broker --pairing-code
  3. Type that code once into the extension’s side panel, pick a session and attach a tab.

A newer release is the same command with the newer version’s URL: a tarball dependency is pinned to its URL, and dsh plugin update does not move it. DeepSeek Harness Connector page

Universal AI Agent Connector

Free and open source, run from its repository.

Requires Node.js 22 or newer and pnpm. The companion starts on 127.0.0.1:43110 and opens its local dashboard.

  1. Run the companion:

    git clone https://github.com/CorsenAI/universal-ai-agent-chrome-connector.git
    cd universal-ai-agent-chrome-connector
    pnpm install && pnpm build
    pnpm connector
  2. Pair. On the dashboard tab, click the Corsen icon in the toolbar, then Pair. The pairing survives restarts.

  3. Connect your agents from the dashboard, the side panel, or:

    pnpm connector setup

    Every change makes a timestamped .bak first, with Unlink and Restore.

pnpm connector <command> runs any companion command from the checkout, for example pnpm connector dashboard. Universal AI Agent Connector page