Skip to main content
Complete this procedure to start Handshake.

​
Prerequisites

  • Use macOS or Linux.
  • Install at least one supported coding agent.
  • Use Go 1.25 or later only if you build Handshake from source.

​
Install and configure Handshake

1

Install Handshake

Select one installation method.
2

Run the setup

Run:
The setup detects agents, creates ~/.handshake/sessions.db, installs integrations and managed skills, and installs the login service.If port 8765 is not available, setup selects another loopback port and gives the selected URL to each agent.
3

Verify the service

Run:
Use the selected port if setup did not use 8765. The response must be ok.
4

List your sessions

Open a connected agent. Enter:
Handshake imports applicable Codex sessions and returns the recent session list.
5

Restore a session

Enter a restore request with the session title or ID:
Review the restore packet. Confirm the restore when the Git state is correct.
Handshake is ready when the health endpoint returns ok and an agent can list sessions.