Skip to main content
Handshake reads OpenCode sessions from ~/.local/share/opencode/opencode.db.

​
Installed integration

handshake setup can install:
  • An MCP entry in ~/.config/opencode/opencode.json.
  • ~/.config/opencode/plugins/handshake.js.
  • A plugin reference in the OpenCode configuration.
  • Managed Handshake skills.
The plugin sends session updates after completed responses. Setup writes the resolved Handshake URL into the plugin.

​
Connect OpenCode

1

Run setup

Run:
2

Restart OpenCode

Restart OpenCode so that it loads the plugin and MCP entry.
3

Verify the connection

Enter:
If the OpenCode configuration does not exist, setup creates it. Import stored OpenCode sessions with: