Skip to main content
Handshake reads Claude Code JSONL transcripts from ~/.claude/projects/<encoded-directory>/<session-id>.jsonl.

​
Installed integration

handshake setup can install:
  • An MCP registration for the Handshake URL.
  • PreCompact, PostCompact, and Stop hooks in ~/.claude/settings.json.
  • Python hook scripts in ~/.claude/hooks/.
  • Managed Handshake skills in the Claude Code skill directory.
The hooks checkpoint before compaction, record the compaction summary, and synchronize after a completed turn.

​
Connect Claude Code

1

Check the prerequisites

Make sure that the claude command and Python 3 are on PATH.
2

Run setup

Run:
3

Restart Claude Code

Close and open Claude Code after setup completes.
4

Verify the connection

Enter:
If the claude command is not available, setup prints the manual MCP command. If Python 3 is not available, MCP tools still work but automatic hooks do not. Import older sessions with: