Install Ricord in Claude Code
Three commands and an in-terminal smoke test. Persistent memory wired into Claude Code in 60 seconds — survives across sessions, across repos, across machines.
Prerequisites
- Claude Code installed and authenticated (
claude --versionworks). bunon your PATH (install Bun if you don't have it).- A Ricord account — sign up if you don't have one.
Step 1 — Install the Ricord CLI
bun add -g ricord
Verify:
ricord --version # → ricord vX.Y.Z
Step 2 — Log in
ricord login
Sign in via the browser tab that opens. The CLI stores your API key in the OS keychain — no env vars to manage, no .env to commit by accident.
Step 3 — Wire into Claude Code
ricord install
Under the hood this is equivalent to:
claude mcp add ricord ricord mcp
...which registers ricordas an MCP server in Claude Code's user-scope config (~/.claude.json). Confirm with:
claude mcp list # → ricord: ricord mcp - ✓ Connected
If you see ✓ Connected, you're wired up.
Step 4 — Start a fresh session
Claude Code reads MCP config at session start. If you have an active claude session running, exit it (Ctrl-C twice or /exit) and start a new one:
claude
Inside the session, check that the tools loaded:
/mcp # → Lists ricord with 13 tools
Step 5 — 30-second smoke test
Inside the session, type:
Remember that this repo deploys with bash deploy.sh.
Claude calls ricord_save. You'll see the tool call inline.
Now /exit, then claude again to start a fresh session. Type:
How do I deploy this repo?
Claude calls ricord_recall and answers with bash deploy.sh. The install is good.
What to expect over the next week
- Day 1: Claude Code saves and recalls when you ask explicitly across
claudesessions. - Day 3: Claude starts calling
ricord_get_contextat the top of each session — picks up the architectural decisions from previous sessions without you re-explaining. - Day 7: Open the dashboard — a wiki page per repo, backlinks between concepts you've worked on, contradictions resolved as your codebase evolved.
Project scope vs user scope
ricord install registers Ricord at user scope by default — every claudesession across every repo on your machine sees the same memory, scoped internally per project so they don't leak into each other.
If your team wants Ricord at project scope (committed to the repo so every contributor gets it), use the project-scope variant of claude mcp add:
claude mcp add --scope project ricord ricord mcp
This writes to .mcp.json at the repo root. Commit it. Each contributor still needs their own ricord login — credentials never leave the OS keychain.
Troubleshooting
claude mcp list shows ricord as Failed. Run claude mcp get ricord to see the error. Common causes:
ricord: command not found— Claude Code can't see the bun-installed binary. Checkwhich ricordin the same shell whereclauderuns.- Auth errors — re-run
ricord login.
Tools loaded but Claude never calls them. Check that /permissions includes mcp__ricord__*. If your settings whitelist individual tools, add Ricord's 13 tools or use the wildcard.
Recall is empty after a few sessions. Background indexing runs every ~10 minutes. If the dashboard also shows zero memories after an hour of active use, run ricord usage to confirm the account is healthy.
Same install, other clients
ricord installauto-detects Claude Desktop, Cursor, and Codex if they're also on the machine. Wires them all to the same memory. Switch between Claude Code and Cursor mid-debugging — both see the same wiki.