# Hermes Jetstream: Hermes Agent plugin

> NATS JetStream event bus: agents publish events (nats_publish), pull one batch (nats_fetch), and wake on subject matches — live-session watches or wake routes (config-declared or runtime-registered via jetstream_wake)…

Canonical: https://hermeswatcher.com/plugins/hermes-jetstream  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/hermes-jetstream  
Last updated in catalog: 2026-10-18

NATS JetStream event bus: agents publish events (nats_publish), pull one batch (nats_fetch), and wake on subject matches — live-session watches or wake routes (config-declared or runtime-registered via jetstream_wake) with durable consumers, manual ack, an idempotent wake ledger and rate rails; an opt-in lifecycle tap mirrors Hermes events onto hermes.> subjects.

## Good to know before installing

Connects only to the NATS servers in your own config (no third-party calls, no telemetry); the platform adapter holds persistent subscriptions and reconnect loops for the gateway's lifetime; token/nkey/user-pass secrets come from ${VAR} references read via the profile-scoped secret scope and a configured creds file is read from its path, never written or rotated; wake routes render event payloads into prompts that start gateway turns or fire an existing cron job (optionally under another named profile), the agent itself can add up to 16 durable wake routes with jetstream_wake that persist in plugin data across restarts (subject still limited to subscribe_allowed, no cron-job or cross-profile targets), and jetstream_watch injects matching events into the live session when allow_gateway_injection is on, so keep subscribe_allowed scoped to trusted publishers.

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 hermes-jetstream
```

2. Said no? Turn it on later:

```bash
hermes plugins enable hermes-jetstream
```

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: Cost, speed & monitoring, Chat apps & voice
- Maintained by: atbrace (Community)
- Needs: No API keys declared
- Adds tools: `nats_publish`, `nats_fetch`, `jetstream_watch`, `jetstream_unwatch`, `jetstream_list`, `jetstream_status`, `jetstream_wake`
- Requires Hermes: `>=0.21.4`
- Version: 1.2.0
- In the catalog since: 2026-10-17, updated 2026-10-18

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/hermes-jetstream)
- [Source code](https://github.com/atbrace/hermes-jetstream)
- [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