RepoMemory plugin for Claude Code
RepoMemory is shared project memory for AI codingagents: the decisions, lessons, guardrails and tasks of a codebase, whichClaude Code, Cursor, Codex and other agents read before they change code.
This plugin connects Claude Code to it in one step:
- The RepoMemory MCP server:
brief,recall,record_entry,claim_taskandretire_entry. - The project's brief at the start of every session: its guardrails, opentasks and latest decisions are in the context before your first prompt, atstartup, after
/clearand after compaction. No rules to paste, and noguardrail missed because the agent forgot to look.
Install
In Claude Code:
/plugin marketplace add Plexsicity/repomemory-plugin
/plugin install repomemory@repomemory
Or from a terminal:
claude plugin marketplace add Plexsicity/repomemory-plugin
claude plugin install repomemory@repomemory
Claude Code asks for your RepoMemory API key when you enable the plugin.Create one at https://repomemory.dev/dashboard/keys (the free plan needs nocard). If it doesn't ask, or to change the key later, run/plugin configure repomemory@repomemory. The key is kept in your system'scredential store.
How it picks the project
The brief is for the first of:
REPOMEMORY_PROJECT, if set.- The project named in the repository's
CLAUDE.mdorAGENTS.md(## Project memory (RepoMemory, project "owner/repo")). - The git remote's
owner/repo. - The folder's name.
If no ledger has that name yet, the agent is shown the account's projectsinstead, so it can use the right one rather than start a second.
What it sends
The hook sends your API key and the project name tohttps://api.repomemory.dev/v1/brief. Reading the brief is free. Nothing elseleaves your machine unless the agent calls a RepoMemory tool. See theprivacy policy.
Requirements
Node 18 or later on PATH, for the session-start hook. Without Node, withouta key, or if the API can't be reached, sessions start as usual with a one-linenotice.
With a key, the MCP tools' calls are charged to the key's account. Withoutone, Claude Code asks you to sign in with your Plexsicity account the firsttime a tool is used (once the server treats an empty X-API-Key as absent).
Development
npm test # the hook's tests
claude plugin validate plugins/repomemory # the plugin
claude plugin validate . # the marketplace
claude --plugin-dir plugins/repomemory # try local changes
REPOMEMORY_URL points the hook at another API. Details are inplugins/repomemory/README.md.
License
MIT