# ROW Recall

> Git remembers what you committed. ROW Recall remembers what happened.

ROW Recall is a local-first, privacy-first memory layer for AI-native software
development. It automatically records every change in a workspace (including
changes made by AI agents), keeps a continuous, searchable timeline, tracks AI
sessions, and lets you restore any moment in seconds — without commits or manual
snapshots. Everything is stored locally in an encrypted database.

## What it does

- Continuous timeline of every file event (create / write / delete / move)
- Checkpoints (snapshots), restore / rollback, and undo / redo of every restore
- AI session detection and attribution (which agent changed what)
- Parallel branches for exploring alternate approaches
- Workspace management (multiple workspaces, Pro supports up to 5)
- Optional HMAC-signed team webhooks

## Privacy & security

- Local-first: no cloud, no telemetry, no training on your data
- Timeline databases encrypted at rest with SQLCipher (AES-256)
- One shared DB key in the OS secure store (DPAPI / Keychain) + hardware wrap
- Optional passphrase-based cross-device recovery (Stage 0)
- Honest scope: protects data at rest; not a malware sandbox or disk encryption

## Key links

- [Homepage](https://rowrecall.com/)
- [Documentation index](https://rowrecall.com/docs/index.html)
- [Quickstart](https://rowrecall.com/docs/index.html)
- [Installation](https://rowrecall.com/docs/install.html)
- [CLI reference](https://rowrecall.com/docs/cli.html)
- [Desktop app](https://rowrecall.com/docs/desktop-usage.html)
- [Concepts](https://rowrecall.com/docs/concepts.html)
- [Security & privacy](https://rowrecall.com/docs/security-privacy.html)
- [Integrations](https://rowrecall.com/docs/integrations.html)
- [Licensing & plans](https://rowrecall.com/docs/license-plans.html)
- [Agent API](https://rowrecall.com/docs/api.html)
- [Pricing](https://rowrecall.com/pricing.html)
- [Download](https://rowrecall.com/download.html)
- [Changelog](https://rowrecall.com/changelog.html)
- [GitHub (releases)](https://github.com/rowstudios/recall-releases)
- [Blog](https://blog.rowrecall.com/) — [Blog index for LLMs (llms.txt)](https://blog.rowrecall.com/llms.txt) · [Blog full text for LLMs (llms-full.txt)](https://blog.rowrecall.com/llms-full.txt)
- [Full documentation for LLMs (llms-full.txt)](llms-full.txt)

## CLI quick reference (`recall`)

- `recall status` — files added / modified / deleted since last checkpoint
- `recall checkpoint [-l label]` — create a checkpoint snapshot
- `recall restore <event_id> [file]` — restore workspace or one file
- `recall undo` / `recall redo` — undo/redo the last restore
- `recall log [-n N] [--file path]` — list recent events
- `recall diff <event_id> [--to-event-id N] [--file path]` — unified diff
- `recall branch [name] [--switch name]` — create/list/switch branches
- `recall where` — print workspace + database paths
- `recall watch` — stream events as they are recorded
- `recall license status|activate <key>|redeem <code> [--email]|machine|deactivate`
- `recall workspace list|add <path>|switch <id>|remove <id>`
- `recall webhook set <url> [secret]|status|clear`
- `recall recovery status|enable|disable|build|apply|where` (Stage 0)

## Agent API

Agents talk to the engine over a local WebSocket (`ws://127.0.0.1:9876`) or the
MCP server `@rowai/mcp-server`. Commands: `checkpoint`, `rollback`,
`restore_file`, `undo`, `redo`, `undo_redo_state`, `diff`, `changed_files`,
`status`, `branch`, `branch_switch`, `branch_list`, `workspace_list`,
`workspace_switch`, `ai_sessions`, `license_status`, `webhook_status`.
See the [Agent API](https://rowrecall.com/docs/api.html) reference.