Install Claude Recall.

One npm install, then start the daemon. Two commands. Claude Code and Codex sessions are both indexed from disk. Nothing leaves your machine silently.

Install in two commands

npm install -g @clauderecallhq/cli

recall start && recall open

Requires Node 22 or newer. Ships as @clauderecallhq/cli on npm. Also available as a VS Code extension and an MCP server.

Requirements

Node 22 LTS or newer (node --version)
macOS (Apple Silicon or Intel), Linux x64 / arm64 (glibc), or Windows 10+ x64. Alpine (musl) and 32-bit platforms are not supported. npm install will be rejected.
At least one supported agent installed, with at least one saved session. Claude Code writes to ~/.claude/projects/, Codex writes to ~/.codex/sessions/. Either one on its own is enough. When both are present, both are indexed.

First run

Three interactive entry points. They all read the same SQLite database, so you can switch between them at any time.

recall start            # background daemon (file watcher + local HTTP)
recall                  # branded welcome dashboard with a slash command palette
recall tui              # full terminal UI: arrow-key browse, live search, preview pane
recall open             # web UI in your browser

The dashboard and the TUI both read the local database directly, so you can browse without starting the daemon. The daemon is required for the web UI and for the TUI's o shortcut (open selected session in browser).

Sources

Codex needs no configuration. The daemon watches ~/.codex/sessions/ alongside ~/.claude/projects/, and picks Codex up automatically whenever that folder is there. To be walked through it instead, recall setup prints the sources it detected, Claude Code and Codex, with the number of saved Codex session files it can see, then lets you index every enabled source or pick one.

Every session keeps the source it came from. The web UI has a source filter with All, Claude Code and Codex, and the CLI takes the same choice as a flag.

recall list                       # every source, newest first
recall list --source codex        # Codex only
recall list --source claude-code  # Claude Code only

Add the MCP server to Claude Code

Once installed, wire Recall into Claude Code as a native tool. This step is optional and specific to Claude Code. Indexing, search and the source filter all work without it. Full MCP setup docs →

{
  "mcpServers": {
    "recall": {
      "command": "claude-recall-mcp"
    }
  }
}

Updating

recall update has two modes. --global installs the latest published package, detecting whether you use npm, pnpm, yarn, or bun. --local rebuilds a source checkout. With no flag, a checkout goes local and everything else goes global. It asks before it runs anything.

recall update --global  # install the latest published package
recall update --local   # rebuild a source checkout: pull + build + restart
recall update           # auto: checkout -> local, anything else -> global

recall update --yes     # skip the prompt (scripts, CI)
recall update -n        # show the plan, run nothing
recall --version        # confirm what you are on

--global works from anywhere, including inside a checkout. After a global update, restart the daemon so it picks up the new build: recall stop && recall start. Local mode does that for you. Your index is untouched by an update either way, and your session files are never modified: Recall opens ~/.claude/projects/ and ~/.codex/sessions/ read-only and writes to neither. Full install & updating docs →

Note that recall upgrade is a different command: it opens the Pro pricing page. Pro is a one-time purchase with lifetime updates, so recall update works the same on Free and Pro.

Troubleshooting

Run recall status to see daemon state and the indexed session count. Once Codex is present, recall doctor adds a Codex section: the Codex home it reads, whether the source is enabled, how many session files it can see, and how many of those it has ingested. Check ~/.recall/daemon.log for errors.