# Handshake

## Docs

- [Claude Code](https://docs.gethandshake.dev/agents/claude-code.md): Set up Handshake with Claude Code to checkpoint sessions automatically, switch agents mid-task, and restore exactly where you left off.
- [Codex](https://docs.gethandshake.dev/agents/codex.md): Set up Handshake with Codex to auto-ingest sessions on list, checkpoint with natural language, and restore your work across any supported agent.
- [Hermes](https://docs.gethandshake.dev/agents/hermes.md): Set up Handshake with Hermes to checkpoint sessions automatically via a plugin hook, use natural language commands, and restore across agents.
- [OpenCode](https://docs.gethandshake.dev/agents/opencode.md): Set up Handshake with OpenCode to auto-sync sessions via a JavaScript plugin, checkpoint with natural language, and restore across agents.
- [Environment Variables](https://docs.gethandshake.dev/configuration/environment-variables.md): Complete reference for HANDSHAKE_ADDR and HANDSHAKE_URL — the two variables that control where the Handshake daemon listens and what URL agents connect to.
- [Overview](https://docs.gethandshake.dev/configuration/overview.md): Learn what you can configure in Handshake — listen address, port, and MCP endpoint URL — and when you need to change them from their defaults.
- [Port](https://docs.gethandshake.dev/configuration/port.md): Move Handshake to a different port when 8765 is already in use, or pin a specific port for consistent access across reinstalls. Covers macOS and Linux.
- [Checkpointing](https://docs.gethandshake.dev/guides/checkpointing.md): Save a snapshot of your current session — full conversation, git state, decisions, and next steps — so you can restore or hand it off later.
- [Handoff Brief](https://docs.gethandshake.dev/guides/handoff-brief.md): Learn what sections make up a Handshake handoff brief — original goal, current state, decisions, and transcript — and how the receiving agent uses it.
- [Searching Sessions](https://docs.gethandshake.dev/guides/searching-sessions.md): Use full-text search to find decisions, file names, and topics discussed across your checkpointed sessions.
- [Switching Agents](https://docs.gethandshake.dev/guides/switching-agents.md): Restore a checkpointed session and pick up exactly where you left off.
- [How It Works](https://docs.gethandshake.dev/how-it-works.md): Learn how Handshake's background daemon reads native agent storage, captures git state, and generates structured handoff briefs to keep sessions portable.
- [Introduction](https://docs.gethandshake.dev/introduction.md): Handshake is a local-first daemon that makes AI coding sessions portable across  coding agents with no cloud required.
- [Quickstart](https://docs.gethandshake.dev/quickstart.md): Install Handshake with a single curl command or via Homebrew, run the setup wizard, and checkpoint your first session in about a minute.
- [CLI](https://docs.gethandshake.dev/reference/cli.md): Complete reference for all handshake CLI commands, including setup, list, restore, serve, install-service, uninstall, and version.
- [MCP Tools](https://docs.gethandshake.dev/reference/mcp-tools.md): Reference for all six Handshake MCP tools: checkpoint_session, list_sessions, restore_session, generate_brief, search_session, and search_all_sessions.
- [Privacy](https://docs.gethandshake.dev/reference/privacy.md): Handshake stores all session data locally on your machine in a SQLite database. No telemetry, no cloud sync, and no accounts of any kind.
- [Uninstall](https://docs.gethandshake.dev/reference/uninstall.md): Step-by-step guide to removing Handshake: stops the daemon, deregisters from all agents, and optionally deletes your session history and binary.