Skip to main content
All install guides
Install guide~60s total

Install Ricord in Zed

Three commands and a settings.json edit. Persistent memory wired into Zed's AI panel in 60 seconds — same memory follows you to Claude Desktop, Cursor, and Codex if you also have them.

Prerequisites

  • Zed 0.149 or later (MCP/context-server support is in current builds).
  • bun on 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. The CLI stores your API key in the OS keychain — no env vars, no .env to commit.

Step 3 — Wire into Zed

ricord install

For Zed, this edits:

  • macOS / Linux: ~/.config/zed/settings.json
  • Windows: %APPDATA%\Zed\settings.json

Zed uses a context_servers key (its name for MCP servers). The block added looks like:

{
  "context_servers": {
    "ricord": {
      "command": {
        "path": "ricord",
        "args": ["mcp"]
      }
    }
  }
}

Existing context_servers entries are preserved. If you prefer per-project scope, write the same block to .zed/settings.json at the project root and Zed merges it with the global settings.

Step 4 — Restart Zed

Cmd-Q + reopen, not close-window. Zed only registers context servers at process startup.

Confirm registration: Cmd-? → open the AI panel → the model selector should show available tools including the Ricord ones (ricord_save, ricord_recall, ricord_get_context, etc.).

Step 5 — Smoke test in the AI panel

Open the AI panel and type:

Remember that this project uses cargo-nextest for the test runner.

Zed calls ricord_save. You'll see the tool call inline.

Close the AI panel chat (new conversation), then ask:

How do I run tests in this project?

Zed calls ricord_recall and answers with cargo nextest. The install is good.

What to expect over the next week

  • Day 1: Zed's AI panel saves and recalls when you ask explicitly. Memory survives between conversations.
  • Day 3: Zed starts calling ricord_get_context proactively when you open a new conversation in a project — pulls in the architectural context from previous sessions.
  • Day 7: Open the dashboard — wiki pages per repo with the cargo/clippy/test patterns you and Zed worked through.

Troubleshooting

AI panel shows no Ricord tools. Open ~/.config/zed/settings.json and verify thecontext_serversblock is well-formed JSON (trailing comma after the last key is the most common issue — Zed's parser is strict about it).

Context server is registered but tools fail with command not found.Zed launched from Finder doesn't inherit your terminal's PATH; the bun-installed ricordbinary isn't visible. Either launch Zed from a terminal (open -a Zed) or change the path in settings.json to an absolute path like /Users/<you>/.bun/bin/ricord.

Recall returns empty. Background indexing runs every ~10 minutes. If the dashboard also shows no memories after an hour of active use, run ricord usage to verify account health.

Same install, other clients

ricord install auto-detects Claude Desktop, Claude Code, Cursor, and Codex too. Same memory backend serves all of them — switch between Zed and Claude Desktop on the same project, both clients see the same wiki + recall the same facts.