basicmachines-co/basic-memory

AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN

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.

This repository also configures its own agents. See what basic-memory tells them →

4.2kStars on the repository
58Mods indexed here, across every type
2d agoLast push, which is what freshness is scored on
AGPL-3.0Licence, which decides whether bodies are shown

basic-memory

01

basicmachines-co/basic-memory

Skill Claude CodeCodex

Use the Basic Memory knowledge graph for persistent memory across sessions. Search before answering; capture decisions, meetings, and insights as notes.

not rated 4.2k +111 changed 16d ago A SkillSpector: warn 29 tokens AGPL-3.0

memory-capture

02

basicmachines-co/basic-memory

Skill Claude CodeCodex

Capture a working thread's current state into one coherent Basic Memory note; on re-capture, rewrite it in place. Use mid- or end-of-thread when decisions, insights, or context are worth keeping.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 46 tokens AGPL-3.0

memory-ci-capture

03

basicmachines-co/basic-memory

Skill Claude CodeCodex

Internal CI skill: synthesize GitHub delivery context into a Basic Memory project update. Use after bm ci collect; return only AgentSynthesis JSON for bm ci publish.

not rated 4.2k +111 changed 3d ago A Socket: passSnyk: passSkillSpector: pass 41 tokens AGPL-3.0

memory-continue

04

basicmachines-co/basic-memory

Skill Claude CodeCodex

Resume prior work by rebuilding context from the Basic Memory graph via memory:// URLs, recent activity, and search. Use at session start or on 'continue with...', 'back to...', 'where were we?'.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 45 tokens AGPL-3.0

memory-curate

05

basicmachines-co/basic-memory

Skill Claude CodeCodex

Curate the Basic Memory graph: link orphan notes, propose typed relations, merge duplicates, audit tags and folders, build hub notes. Use to organize and connect a knowledge base as notes accumulate.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 43 tokens AGPL-3.0

memory-defrag

06

basicmachines-co/basic-memory

Skill Claude CodeCodex

Defragment a Basic Memory project: split bloated notes, consolidate scattered facts, resolve contradictions, retire stale content. Plans first; deletes only when told. Run weekly or on demand.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 42 tokens AGPL-3.0

memory-ingest

07

basicmachines-co/basic-memory

Skill Claude CodeCodex

Turn meeting transcripts, conversation logs, or pasted documents into structured Basic Memory notes: match existing entities, propose new ones with approval, and capture action items.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: warnSkillSpector: pass 35 tokens AGPL-3.0

memory-lifecycle

08

basicmachines-co/basic-memory

Skill Claude CodeCodex

Manage note status transitions in Basic Memory: archive completed work, move notes between status folders, update frontmatter. Use when marking items complete or archiving entities.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 36 tokens AGPL-3.0

basicmachines-co/basic-memory

Skill Claude CodeCodex

Analyze a complete literary work into a structured Basic Memory knowledge graph: schema design, entity seeding, chapter-by-chapter processing, cross-referencing, and validation.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: warn 38 tokens AGPL-3.0

basicmachines-co/basic-memory

Skill Claude CodeCodex

Search Basic Memory notes by custom frontmatter fields with equality, range, array, and nested filters. Use when finding notes by status, priority, confidence, or any YAML field, not free text.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 45 tokens AGPL-3.0

memory-notes

11

basicmachines-co/basic-memory

Skill Claude CodeCodex

How to write well-structured Basic Memory notes: frontmatter, categorized observations, wiki-link relations, and knowledge-graph best practices. Use when creating or improving notes.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 38 tokens AGPL-3.0

memory-onboarding

12

basicmachines-co/basic-memory

Skill Claude CodeCodex

Help a new user design a Basic Memory knowledge system and set up their assistant to load it. Use when someone is getting started, has an empty or messy project, or wants context kept across sessions.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: warnSkillSpector: warn 44 tokens AGPL-3.0

memory-reflect

13

basicmachines-co/basic-memory

Skill Claude CodeCodex

Sleep-time reflection: review recent Basic Memory activity and fold lasting decisions, lessons, and facts into the notes they belong in. Run 1-2x daily, on a heartbeat, or when asked.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 45 tokens AGPL-3.0

memory-research

14

basicmachines-co/basic-memory

Skill Claude CodeCodex

Research an external subject on the web and synthesize it into a structured Basic Memory note. Use when asked to research a company, person, technology, or topic, or given a bare name or URL.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: warnSkillSpector: pass 45 tokens AGPL-3.0

memory-schema

15

basicmachines-co/basic-memory

Skill Claude CodeCodex

Manage Basic Memory schemas: find unschemaed notes, infer and edit schemas, validate notes, detect drift. Use when structured note types (Task, Person, Meeting) need consistency across the graph.

not rated 4.2k +111 changed 3d ago A Socket: passSnyk: passSkillSpector: pass 43 tokens AGPL-3.0

memory-tasks

16

basicmachines-co/basic-memory

Skill Claude CodeCodex

Task management via Basic Memory schemas: create, track, and resume structured tasks that survive context compaction. Uses BM's schema system for uniform notes queryable through the knowledge graph.

not rated 4.2k +111 changed yesterday A Socket: passSnyk: passSkillSpector: pass 40 tokens AGPL-3.0

basicmachines-co/basic-memory

Skill Claude CodeCodex

Set up Basic Memory for a Pi workspace. Use when Basic Memory is not configured, /bm-status shows no project, recall returns setup guidance, or the user asks to enable durable memory, choose CLI vs MCP, or configure automatic continuity.

not rated 4.2k +111 changed 1mo ago A 55 tokens AGPL-3.0

basic-memory-pi

18

basicmachines-co/basic-memory

Skill Claude CodeCodex

Use Basic Memory from Pi for durable continuity. Capture checkpoints with bmcapture, recall prior Pi checkpoints with bmrecall, and consult bundled Basic Memory skill references for note/task structure without assuming direct Basic Memory MCP tool names are available.

not rated 4.2k +111 2d ago A 51 tokens AGPL-3.0

basic-memory-setup

19

basicmachines-co/basic-memory

Skill Claude CodeCodex

Guide Basic Memory setup in Tau. Use when a user wants to install or configure the Tau memory extension, choose a memory destination or capture policy, verify connectivity, or troubleshoot setup. Check compatibility and obtain approval before installation, configuration changes, or test writes.

not rated 4.2k +111 2d ago A 56 tokens AGPL-3.0

memory-comark

20

basicmachines-co/basic-memory

Skill Claude CodeCodex

Write Basic Memory notes that render as charts, tables, boards, and live views with ::bm- Comark components. Use when a note reads better as a figure or board, or already has ::bm- directives.

not rated 4.2k +111 changed 3d ago A 52 tokens AGPL-3.0

memory-quest

21

basicmachines-co/basic-memory

Skill Codex

Finish Memory Quest Mission 8: confirm this assistant reaches Basic Memory Cloud and starts from Basic Memory, then, with approval, save a Memory Master note with the user's verification code.

not rated 4.2k +111 2d ago A 40 tokens AGPL-3.0

memory-okf

22

basicmachines-co/basic-memory

Skill Claude CodeCodex

Make a Basic Memory project ready for OKF v0.2 export by finding and fixing what blocks it. Use when preparing a project for OKF export, publishing, or handoff, or checking an OKF bundle.

not rated 4.2k +111 2d ago A 49 tokens AGPL-3.0

At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: