Skip to main content
Handshake is a local daemon for coding-agent sessions. It reads native agent session data, stores checkpoints on your computer, and creates a handoff brief when you restore a session.

Install Handshake

Install the binary and connect your agents.

List sessions

Find a session and identify its project and agent.

Restore a session

Review Git drift and continue work in another agent.

CLI reference

Find the syntax for each Handshake command.

​
Basic workflow

1

Install Handshake

Install the binary with the curl installer, Homebrew, or the source code.
2

Connect your agents

Run handshake setup. The command creates the database, installs the integrations, and starts the login service.
3

List your sessions

Enter list my sessions in a connected agent.
4

Restore your work

Ask the receiving agent to restore the applicable session. Review the Git drift before you confirm the restore.
Session data stays on your computer. Release builds can send limited anonymous usage events. You can disable these events. See Privacy.