Skip to main content
Handshake reads Hermes sessions from ~/.hermes/state.db with a read-only SQLite connection.

​
Installed integration

handshake setup can install:
  • An MCP entry in ~/.hermes/config.yaml.
  • A plugin in ~/.hermes/hooks/handshake/.
  • Managed Handshake skills.
The plugin synchronizes a session after a completed turn.

​
Connect Hermes

1

Run setup

Run:
2

Restart Hermes

Restart Hermes so that it loads the plugin.
3

Verify the connection

Enter:
If ~/.hermes/config.yaml does not exist, setup prints the MCP configuration that you must add. Import stored Hermes sessions with: