basic-memory

basic-memory is a skill for Claude Code, Codex from basicmachines-co/basic-memory. It costs 29 tokens per session (2,768 once invoked), scanned A, original, AGPL-3.0.

A persistent knowledge graph for saving and finding project information across coding sessions.

In plain words
What is it for?
Searching stored project notes before answering and recording important decisions or discoveries for future work.
Why use it?
It lets an agent reuse earlier decisions, meetings, and insights instead of starting with no memory in each new session.

Skill for Claude CodeCodex

Which agent this was written for is unclear — body not stored (licence); the path alone says nothing.

Good fit Searching stored project notes before answering and recording important decisions or discoveries for future work.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/basicmachines-co/basic-memory/skill
About the project

Basic Memory is a local-first knowledge system that stores notes as Markdown files and connects them into a searchable knowledge graph for AI conversations. People and AI assistants use it to preserve project context across Claude, Codex, Cursor, ChatGPT, and other MCP-compatible clients. The catalogue add-ons provide Basic Memory skills, commands, instructions, MCP integrations, hooks, settings, and a plugin.

basicmachines-co/basic-memory · 4,251 stars · on GitHub · basicmemory.com

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add basicmachines-co/basic-memory --skill skill
Clone the repo
git clone --depth 1 https://github.com/basicmachines-co/basic-memory

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for basic-memory

README.md
[![agentmods](https://agentmods.dev/badge/skills/basicmachines-co/basic-memory/skill/github.svg)](https://agentmods.dev/skills/basicmachines-co/basic-memory/skill)
Your own site
<a href="https://agentmods.dev/skills/basicmachines-co/basic-memory/skill"><img src="https://agentmods.dev/badge/skills/basicmachines-co/basic-memory/skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for basic-memory

Your own site · 80×15
<a href="https://agentmods.dev/skills/basicmachines-co/basic-memory/skill"><img src="https://agentmods.dev/badge/skills/basicmachines-co/basic-memory/skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 29 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,768 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 1 finding, up to medium

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • medium Excessive Agency · line 226
    Skill enables autonomous high-impact decisions without human-in-the-loop verification. Critical operations (destructive commands, financial transactions, data deletion) should require explicit user confirmation.
    Fix: Add human-in-the-loop confirmation for destructive, irreversible, or high-impact operations. Never auto-execute commands that modify files, send data, or alter system state.
How audits are shown
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00029 $0.02768
Opus 5.5 $0.00012 $0.01107
Sonnet 5.5 $0.00006 $0.00554
Haiku 4.5 $0.00003 $0.00277

Measured 17d ago against content hash 720e43273055, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

basic-memory scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 17d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

integrations/hermes/skill/SKILL.md · 210 lines

The source is not reproduced here

Licensed AGPL-3.0

The repository is licensed AGPL-3.0, which this catalogue does not treat as permission to reproduce the file. Read it at the source.

Read it on GitHub

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 17d ago Changed · -34 lines 720e43273055
  2. 1mo ago First seen · 244 lines · 29 tokens per session scan A 94100f765ec9

Subscribe to this mod's changes

basic-memory is a skill published in the GitHub repository basicmachines-co/basic-memory (4,251 stars, last pushed today), licensed AGPL-3.0. It adds 29 tokens to every session and 2,768 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

memory-triage

Persistent long-term memory protocol powered by mem0. Evaluate conversations for durable facts worth storing via memoryadd. Handles identity, preferences, decisions, configurations, rules, projects, and relationships. Loaded by the openclaw-mem0 plugin when skills mode is active.

mem0ai/mem0 · 58 tokens

mem0

Mem0 Platform SDK for adding persistent memory to AI applications. TRIGGER when: user mentions "mem0", "MemoryClient", "memory layer", "remember user preferences", "persistent context", "personalization", or needs to add long-term memory to chatbots, agents, or AI apps. Covers Python SDK (mem0ai), TypeScript SDK…

mem0ai/mem0 · 181 tokens

mem0-cli

Mem0 CLI -- the command-line interface for mem0 memory operations. TRIGGER when: user mentions "mem0 cli", "mem0 command line", "@mem0/cli", "mem0-cli", "pip install mem0-cli", "npm install -g @mem0/cli", or is running mem0 commands in a terminal/shell (mem0 add, mem0 search, mem0 list, mem0 get, mem0 init, mem0…

mem0ai/mem0 · 177 tokens

mem0-vercel-ai-sdk

Mem0 provider for Vercel AI SDK (@mem0/vercel-ai-provider). TRIGGER when: user mentions "vercel ai sdk", "@mem0/vercel-ai-provider", "createMem0", "retrieveMemories", "addMemories", "getMemories", "searchMemories", "mem0 vercel", "AI SDK provider", "AI SDK memory", or is using generateText/streamText with mem0. Also…

mem0ai/mem0 · 146 tokens

mempalace

MemPalace — Local AI memory with 96.6% recall. Semantic search, temporal knowledge graph, palace architecture (wings/rooms/drawers). Free, no cloud, no API keys.

MemPalace/mempalace · 47 tokens

mem0-status

Diagnoses mem0 connectivity, API key validity, and memory read/write functionality. Use when memory operations fail, searches return empty, addmemory errors occur, or to verify the plugin is working correctly.

mem0ai/mem0 · 44 tokens