watchline

Watchline for Hermes Agent

Watchline is an event layer for agents. This Hermes plugin delivers matched
Watchline events into a local Hermes gateway without exposing your laptop to
the internet.

Watchline Hermes delivery flow

Watchline uses two integration planes:

Hosted MCP gives Hermes the watch tools: start_watch,
continue_watch, list_watches, pause_watch, resume_watch, and
delete_watch.
This plugin registers a Hermes gateway platform named watchline. It
polls a Watchline pull channel and forwards matched events as inbound Hermes
messages.

The plugin intentionally does not duplicate Watchline tools. Hermes discovers
tools from the hosted MCP server, and this adapter only handles local delivery.

Install

hermes plugins install qordinate-ai/watchline-hermes-plugin --enable

The package is also available on PyPI:

python -m pip install watchline-hermes-plugin

For local development:

hermes plugins install file:///absolute/path/to/watchline-hermes-plugin --enable

Configure

Create a Watchline API key and pull channel at https://watch.qordinate.ai,
then run:

hermes watchline configure \
  --api-key wl_... \
  --channel-id ch_... \
  --user-id me \
  --delivery-channel main \
  --api-base-url https://api.watch.qordinate.ai

The command writes:

platforms.watchline for delivery.
mcp_servers.watchline for hosted watch tools.

Restart the Hermes gateway after changing plugin or MCP config:

hermes gateway restart

Use

Ask Hermes to use Watchline:

Use the Watchline start_watch tool to watch Gmail for emails from my boss.
Ask me for the sender email address if needed.

When a matching event arrives, Watchline queues it on your pull channel. The
plugin polls that channel, runs Hermes against your main/home channel, and
acknowledges the delivery only after Hermes accepts it.

Why a Hermes Plugin?

Hermes also has a built-in webhook adapter for external events. That is a good
option when your Hermes gateway already has a public URL, reverse proxy, or
tunnel and you want Watchline to push matched events directly into Hermes.

This plugin uses Watchline pull delivery instead. Hermes runs locally, polls the
Watchline channel, and injects matched events into the gateway without requiring
your Hermes agent to expose an inbound webhook endpoint online. You can still
use Hermes webhooks separately for deployments where a public callback URL is
already part of your setup.

Commands

hermes watchline status
hermes watchline install-mcp
hermes watchline preview-delivery

Configuration Reference

| Field | Required | Description |
| ----------------------- | -------- | ------------------------------------------------ |
| api_key | Yes | Watchline project API key. |
| channel_id | Yes | Watchline pull channel ID. |
| user_id | No | Stable Watchline user id. Defaults to me. |
| api_base_url | No | Watchline API base URL. Defaults to production. |
| poll_interval_seconds | No | Delivery polling interval. Minimum is 5 seconds. |
| delivery_channel | No | Hermes delivery target. Defaults to main, the first configured home channel. Use telegram, discord, or telegram:<chat_id>[:thread_id] to override. |