Harness · Hermes Agent

Hermes Agent.

Hermes Agent is an autonomous AI agent from Nous Research with persistent memory across sessions and 40+ built-in tools. It reaches you on Telegram, Discord, and the terminal — and runs whatever skills you wire in. Workbooks plugs in via MCP and becomes one more tool in Hermes' toolbox.

Auto-install

Paste this into Hermes Agent

Click below to copy a self-install prompt. Hermes will edit its own config, reload, and remember the setup across future sessions thanks to its persistent memory.

Or follow the manual steps below.

1. Install the Workbooks CLI

npm install -g @work.books/cli
workbook --version

2. Install Hermes Agent

Hermes ships as a single-command install:

curl -fsSL https://hermes-agent.nousresearch.com/install | sh

Run hermes setup to walk through the model + memory config. Hermes needs at least 64K context — pick a model accordingly.

3. Register Workbooks as an MCP server

Open Hermes' config (default: ~/.hermes/config.toml) and add Workbooks under [tools.mcp]:

[tools.mcp.workbooks]
command = "workbook"
args = ["mcp", "serve"]
description = "Publish and manage Workbooks Studio artifacts"

Then run hermes reload (or restart the agent). Hermes picks up the new tool surface and announces it on next message.

Quirks & tips

Persistent memory is the win. Hermes remembers your Studio workspace, your group slugs, your default publish target. After two or three sessions it'll publish to the right group without being asked.
Skill auto-creation. Hermes can compile a sequence of Workbooks tool calls into a named skill (e.g. "publish-and-revoke-old"). Useful for repeatable team flows.
Cross-channel reach. If you have Hermes wired to Telegram, you can ask it to "publish the pricing simulator workbook to the showcase group" from your phone. The CLI subprocess runs on whatever host Hermes is on.
Auth boundary. The workbook publish OAuth flow expects a browser. If Hermes is running headless, run the first workbook publish manually so the token is in the keychain; Hermes will reuse it from then on.

Verify

Message Hermes: "What workbook groups do I have?" It should invoke the Workbooks MCP server and reply with your group list.