Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add johnlindquist/claude --skill memory -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/memory/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/memory/

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.

memory OrchestKit Search a knowledge graph for earlier decisions, load session context, and inspect decision history. Use it when you need to recover what a project has already settled. CX Codex +1 749installs memory plasma-ai A skill that sets the discipline for a node's persistent memory: what to write, how to split pages, when to prune. Useful when your agent hoards history instead of knowledge. CX Codex +1 ★ 786repo stars memory harperreed A skill that keeps agent notes in SQLite with embeddings and pulls them back by meaning. Useful when project context has to survive across sessions. CX Codex +1 ★ 336repo stars setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set3

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor