1 Cursor macOS · Linux · Windows

One click. Cursor opens a confirmation dialog and writes the entry into its MCP config.

{
  "mcpServers": {
    "crixin": {
      "command": "npx",
      "args": ["-y", "crixin", "--mcp"]
    }
  }
}

Verify: open a fresh Cursor chat and ask "use crixin to list my recent sessions." You should see Cursor call list_recent_sessions and reply with newest sessions across all three sources.

2 Claude Code CLI on macOS · Linux · Windows

One command. The CLI handles the config file edit; restart Claude Code afterwards.

claude mcp add crixin -- npx -y crixin --mcp

Copy command

Or edit ~/.claude/mcp.json by hand

{
  "mcpServers": {
    "crixin": {
      "command": "npx",
      "args": ["-y", "crixin", "--mcp"]
    }
  }
}

Verify: in a new Claude Code session, ask "use crixin to find sessions where I discussed the auth refactor." The host should call search_sessions and reply with snippets + ready-to-paste claude --resume <uuid> commands.

3 OpenAI Codex CLI macOS · Linux

Append the block below to ~/.codex/config.toml. Codex picks up MCP servers on every launch.

[mcp_servers.crixin]
command = "npx"
args = ["-y", "crixin", "--mcp"]

Copy block

Verify: in a new Codex session, "use crixin stats." Codex should call the stats tool and reply with totals (sessions, messages, est. spend, busiest hour).

4 Just the dashboard, no host browser

If you're not running an MCP-aware host yet, you can still use the dashboard standalone:

npx -y crixin

Copy command

The dashboard opens at http://127.0.0.1:<random-port>. First run on a 17k-message history takes ~80s for the BPE-tokenized cost estimate; subsequent runs are sub-second thanks to the mtime cache.

Troubleshooting

"command not found: crixin"

You ran crixin directly without installing globally. Either npx -y crixin … (one-shot) or npm i -g crixin (then plain crixin).

"engine node@>=22 required"

Crixin uses Node's built-in node:sqlite module which lands at Node 22. Upgrade with nvm install 22 or brew install node.

Claude Code doesn't see the new tools

You added the entry but the running session uses its cached MCP list. Quit Claude Code completely (the menu-bar icon, not just the window) and reopen.

Cursor deep-link doesn't open the dialog

Make sure Cursor is your default cursor:// handler. On macOS, run Cursor once with the deep-link manually pasted into Safari's address bar — the OS will register the handler.

First run takes 80 seconds

That's the BPE cost-estimation pass on your full session history. Subsequent runs use the cache at ~/.crixin/crixin.db and start in <1s.

"npx: 404 Not Found"

The npm registry is occasionally unreachable from China / Egypt. Use npm i -g crixin --registry https://registry.npmmirror.com as a fallback.

After install — try this

A few prompts that exercise the four tools we expose. Run them in your AI coding host of choice.

recent activity: "use crixin to show me the 5 most recent sessions." → calls list_recent_sessions
find a past discussion: "crixin: search for 'database migration'." → calls search_sessions with a snippet + resume command per hit
full session content: "crixin: get session <uuid-from-above>." → calls get_session and returns the full transcript as Markdown
year totals: "crixin: what are my total stats?" → calls stats with sessions, messages, est. spend, busiest hour, top projects

Pick your AI coding host.