> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gethandshake.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Data locations

> Reference for the files that Handshake creates and the agent data that it reads.

## 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.

<Warning>
  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.
</Warning>