Integrations

Connect your agents & editors

VS Code, Claude Code, OpenAI Codex, Cursor, Windsurf and any MCP-capable host.

Prerequisite for every agent integration: the ReCall daemon must be running and watching a workspace — launch the desktop app or run recall watch. It listens on ws://127.0.0.1:9876 (override with the RECALL_WS_URL environment variable). The MCP server is a thin bridge to this same daemon, so desktop, CLI, WebSocket and MCP all share one engine and one timeline.

@rowai/mcp-server — shared MCP tools

The @rowai/mcp-server npm package (v0.7.0, AGPL-3.0) exposes the engine to any MCP host. Install once, then register in each host’s config:

npm install -g @rowai/mcp-server

# configure your MCP host (e.g. ~/.claude/settings.json, or npx in any host):
{
  "mcpServers": {
    "recall": {
      "command": "npx",
      "args": ["@rowai/mcp-server"]
    }
  }
}

The server exposes 17 tools:

Tool	Purpose
`checkpoint`	Snapshot the workspace (optional label) — call before risky changes
`rollback`	Restore the workspace or a single file to a past event
`restore_file`	Restore one file to a past event
`undo`	Undo the last restore operation
`redo`	Re-apply the most recently undone operation
`undo_redo_state`	Check whether undo/redo are available and target
`diff`	Unified diff of a file between two events
`changed_files`	Files changed since the last checkpoint
`status`	Event count, delta storage bytes, and daemon uptime
`license_status`	Current plan (free/pro), events used, event cap, days left
`workspace_list`	List tracked workspaces and which is active
`workspace_switch`	Switch the active workspace
`ai_sessions`	List recorded AI agent sessions
`webhook_status`	Whether a team webhook is configured (secret presence only)
`branch`	Create a parallel branch from a checkpoint
`branch_switch`	Switch to an existing branch
`branch_list`	List all branches

Tool names map 1:1 to WebSocket commands, and parameter names match the JSON fields (event_id, file_path, label, since_event_id, from_event_id, name).

VS Code / Cursor / Windsurf

The ReCall extension (rowai.recall) is a standalone, zero-native-dependency extension (WASM SQLite) that works in VS Code and its forks Cursor and Windsurf unchanged. It does not require the desktop app or Git; data stays in VS Code’s protected storage. Install from the Marketplace or side-load the .vsix. It offers a timeline view, checkpoints, rollback (workspace and per-file), event diffs, a Changed-Files view, and undo/redo.

See Installation for the command reference. For Cursor, an example .cursorrules prompts the agent to auto-checkpoint before risky edits.

Claude Code

The Claude Code integration is a plugin shipped from the ReCall plugin marketplace (rowstudios/recall-plugins). In Claude Code:

/plugin marketplace add rowstudios/recall-plugins
/plugin install row-recall@recall-plugins

Installing gives you:

17 MCP tools the agent can call on its own (listed above).

4 slash commands for humans:

Command	What it does
`/checkpoint`	Snapshot the workspace
`/rollback <event_id> [file_path]`	Restore to an event
`/undo`	Undo the last restore
`/redo`	Redo the last undo

An auto-checkpoint PreToolUse hook that snapshots the workspace before every file write or edit (Write/Edit/NotebookEdit), so any risky edit is one rollback away.

Manual install (no marketplace): npm install -g @rowai/mcp-server, register it in ~/.claude/settings.json, and copy the plugin folder to ~/.claude/plugins/row-recall/ for the slash commands and hook. Node 22+ is recommended (the hook uses the built-in WebSocket).

OpenAI Codex

Install the MCP server and register it in ~/.codex/config.toml (or a project-local .codex/config.toml):

npm install -g @rowai/mcp-server

# ~/.codex/config.toml
[mcp_servers.recall]
command = "npx"
args = ["-y", "@rowai/mcp-server"]

Restart Codex; the agent gains the 17 tools above. The Codex plugin ships in the same rowstudios/recall-plugins marketplace repo.

Suggested agent workflow

start your agent (codex, cline, opencode, ...) — Recall detects it
   automatically and creates an auto-checkpoint (session start)
before a big refactor: checkpoint (or ask the agent — it has the tool)
let the agent edit
if something breaks: rollback to the checkpoint's event_id
changed your mind? undo / redo  (every restore is reversible)
review per-session files in the desktop "AI Activity" view, or
   restore to before any session in one click

Troubleshooting

Error	Fix
"ReCall daemon not connected"	Start the desktop app or `recall watch`; the MCP server reconnects automatically
"No workspace configured"	Set a workspace in the desktop UI or via the CLI before checkpointing
Claude Code hook doesn’t fire / WS error	Restart the session; use Node 22+ (built-in WebSocket)