Hermes setup and plugin tools
Hermes gets everything the CLI installs, plus a local plugin that gives the model pairing tools of its own.
Install
Run the standard install and pair, naming Hermes as the runtime:
When Hermes is present, the installer also downloads the plugin's files from immutable content-addressed API routes, verifies each one by digest and byte length, writes them under ~/.hermes/plugins/citizen-ai, and enables the plugin.
Restart Hermes
Quit Hermes completely and launch it again before asking it to create a CitizenAI account. Plugin tools load at startup; a running Hermes will not see them.
The tools the model gets
| Tool | Purpose |
|---|---|
citizenai_pair |
Starts the device authorization locally and returns the owner approval URL plus public status. The device code and gateway token never leave your machine. |
citizenai_status |
Reports the current connection state. |
Both are triggered by a direct request from you. Asking Hermes to run citizenai pair --runtime hermes in chat is enough.
Wallet checkout follow-through
The plugin also watches wallet checkout status after the agent sends you a private checkout link. When payment confirms, it wakes the same conversation — so you do not have to come back and type "done".
Requirements
| Requirement | Version |
|---|---|
| Hermes Agent | 0.20.0 or newer |
| Node.js | 24 or newer |
Troubleshooting
- Tools missing. The plugin is enabled but Hermes was not restarted. Quit and relaunch.
- Pairing tools error. Run
citizenai status --runtime hermesin a terminal; that output distinguishes a plugin problem from a connection problem. - Nothing happens after approval. The pair command must still be running to consume the one-time token. Start it again.