# Topoi: Hermes Agent plugin

> Group your Hermes Agent chats into topics, in Hermes Desktop and in the Dashboard.

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

Group your Hermes Agent chats into topics, in Hermes Desktop and in the Dashboard. A sidebar lists the topics active in the past week with a status dot per thread (working, waiting, unread, idle), a new chat files under your home topic, threads move between topics, and a topic's threads are searchable by message content. Cron job results arrive as topic threads you can reply to, and the reply continues that run's session. The gateway owns one topic registry and both clients read and write it over the plugin's REST API, so an edit in the Dashboard reaches the desktop app.

## Good to know before installing

Registers a no-inbound `topoi` gateway platform adapter in the Hermes process; serves an HTTP API at /api/plugins/topoi/ behind the Dashboard's own origin and auth; writes its topic registry and the `home_channel` projection into the `platforms.topoi` section of config.yaml; keeps session-to-topic bindings in a plugin-private SQLite database; reads the per-profile session databases and cron job store (partly through private core helpers that can change between releases) and marks threads read or deletes them through core's own session routes; bundles one skill; no third-party network calls, no credentials, no telemetry.

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 topoi
```

2. Said no? Turn it on later:

```bash
hermes plugins enable topoi
```

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: Hermes Desktop add-ons, Chat apps & voice
- Maintained by: AlaisterLeung (Community)
- Needs: No API keys declared
- Works on: linux, macos, windows
- Requires Hermes: `>=0.23.0`
- Version: 1.0.0
- In the catalog since: 2026-11-14

## Links

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