memory · johnlindquist — Claude Code skill: what it does, how to install
Connects your coding agent to the basic-memory CLI to store notes, run semantic searches, and keep project context across sessions.
npx skills add johnlindquist/claude --skill memory -a claude-codeWhat memory does
This skill equips agents with persistent storage driven by the basic-memory CLI. It records findings into Markdown notes and categorizes them using tags. Notes remain accessible across restarts.
Searching relies on semantic queries, titles, or date filters. You can also build context trees for paths like memory://topic/... before tackling complex tasks. Without basic-memory installed via pip, the skill cannot run any commands.
The local database updates through basic-memory sync. Each note stays organized with standard frontmatter metadata.
What it helps with
- store architectural choices and patterns across coding sessions
- search saved notes semantically by topic or tag
- load historical context before refactoring or building features
- track recent updates in the local knowledge base
Example prompts for the agent
- Search memory for notes related to JWT authentication
- Save our database schema decision to the decisions folder with tag backend
- Build context for memory://topic/api before we start refactoring
How to install memory
1Skills CLI (Vercel)
npx skills add johnlindquist/claude --skill memory -a claude-code2Manually: put the files in place
~/.claude/skills/memory/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/memory/
1Skills CLI (Vercel)
npx skills add johnlindquist/claude --skill memory -a codex2Manually: put the files in place
.agents/skills/memory/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add johnlindquist/claude --skill memory -a cursor2Manually: put the files in place
.cursor/skills/memory/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install johnlindquist/claude memory2Manually: put the files in place
.github/skills/memory/SKILL.md1Skills CLI (Vercel)
npx skills add johnlindquist/claude --skill memory -a gemini-cli2Platform CLI
gemini skills install https://github.com/johnlindquist/claude --path skills/memoryManually: put the files in place
.devin/skills/memory/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add johnlindquist/claude --skill memory -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about memory
How to install memory in Claude Code?
Run npx skills add johnlindquist/claude --skill memory -a claude-code in your terminal. The configuration is stored in ~/.claude/skills/memory/SKILL.md.
What does the memory skill do?
It gives your coding agent persistent memory by storing Markdown notes, retrieving semantic context, and tracking project decisions across sessions.
What dependencies are required?
You need the CLI package available in your environment. Install it beforehand by running pip install basic-memory.
Similar skills
All skills for Agent setup: memory, context, orchestration →memory by other authors comes first.