Data locations - Handshake

Handshake data

Path	Contents
`~/.handshake/sessions.db`	Sessions, messages, metadata, and update status.
`~/.handshake/knowledge/<project-id>/`	Factual project records and AI-authored knowledge documents.
`~/.handshake/authoring.json`	Background-writer configuration.
`~/.handshake/telemetry_id`	Random anonymous installation ID, unless telemetry is disabled.

Handshake creates ~/.handshake with owner-only access. It restricts the database files to the owner.

Agent data that Handshake reads

Agent	Data location
Claude Code	`~/.claude/projects/`
Codex	`~/.codex/session_index.jsonl` and `~/.codex/sessions/`
Hermes	`~/.hermes/state.db`
OpenCode	`~/.local/share/opencode/opencode.db`

Cursor sends completed session data through its installed hook.

Installed integration files

Handshake can add MCP configuration, hooks, plugins, and managed skills to agent configuration directories. Run handshake uninstall to remove the managed integration files.

Do not edit sessions.db while the Handshake daemon is active. Stop the service before you copy or inspect the database with a tool that can write.