basicmachines-co

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.

basicmachines-co/basic-memory

Plugin Claude Code

The bridge between Claude's working memory and Basic Memory's durable knowledge graph — session briefings, pre-compaction checkpoints, and capture reflexes.

basicmachines-co/basic-memory

Hook

Runs when a session starts, executing session_start.py via uv with --quiet and --script. From basicmachines-co/basic-memory.

basicmachines-co/basic-memory

Hook

Runs before the context is compacted, executing pre_compact.py via uv with --quiet and --script. From basicmachines-co/basic-memory.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Save a deliberate work checkpoint to Basic Memory with the story, changed files, verification, decisions, blockers, and the next action. Use when the user asks to checkpoint, wrap up, hand off, or remember the state of the work.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Capture a durable engineering decision in Basic Memory with rationale, alternatives, consequences, and affected work. Use when the user makes or asks to record a real choice — "let's go with X", "record this decision", or runs /basic-memory:bm-decide.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Orient Claude from Basic Memory before substantial repo work by reading active tasks, open decisions, recent checkpoints, and repo conventions. Use when resuming old work or when the user asks where things stand.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Quickly capture a thought, fact, or reminder into Basic Memory as a lightweight note. Use when the user says "remember that…", "note this", "save this to memory", or runs /basic-memory:bm-remember. For quick deliberate capture — not full decision or session records.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Set up the Basic Memory plugin for this project — a short guided interview that configures the project mapping, seeds note schemas, learns or suggests placement conventions, and enables capture reflexes. Use when the user runs /basic-memory:bm-setup, says "set up basic memory", or asks to configure/bootstrap the…

basicmachines-co/basic-memory

Skill Claude CodeCodex

Promote a note from your personal Basic Memory project to a shared team project, with attribution. Use when the user says "share this with the team", "publish this decision", or runs /basic-memory:bm-share. This is the deliberate way to write to a team workspace — auto-capture never does.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Show the Basic Memory plugin's current state for this project — active project, capture folders, output style, recent session checkpoints, and whether Basic Memory is reachable.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Apply the user-customizable writing standard for Basic Memory notes created or substantially revised by Claude. Use with bm-remember, the basic-memory output style's decision captures, and other Basic Memory note-writing workflows.

basicmachines-co/basic-memory

MCP server Claude CodeCodexCursor +2

Local-first knowledge management combining Zettelkasten with knowledge graphs. Runs locally from the basic-memory Python package.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Capture the current state of a working thread or conversation into a single coherent Basic Memory note — synthesize where it landed, don't append a log. On re-capture, rewrite the same note in place instead of duplicating. Use mid-thread or end-of-thread when decisions, insights, or context are worth preserving.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Synthesize GitHub delivery context into a concise Basic Memory project update. Use in CI after bm ci collect prepares a ProjectUpdateContext; return only structured AgentSynthesis JSON for bm ci publish.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Resume prior work by rebuilding context from the Basic Memory knowledge graph — pick up where you left off using memory:// URLs, recent activity, and search. Use when starting a session or when the user says 'continue with...', 'back to...', or 'where were we?'.

basicmachines-co/basic-memory

Skill Claude CodeCodex

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

basicmachines-co/basic-memory

Skill Claude CodeCodex

Defragment and reorganize agent memory files: split bloated files, merge duplicates, remove stale information, and restructure the memory hierarchy. Use when memory files have grown unwieldy, contain redundancies, or need reorganization. Run periodically (weekly) or on demand.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Process unstructured external input (meeting transcripts, conversation logs, pasted documents) into structured Basic Memory entities. Extracts entities, searches for existing matches, proposes new entities with approval, creates notes with observations and relations, and captures action items.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Manage entity status transitions in Basic Memory: archive completed work, move notes between status folders, update frontmatter, and handle edge cases. Use when marking items complete, archiving old entities, or managing any folder-based status workflow.

basicmachines-co/basic-memory

Skill Claude CodeCodex

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

basicmachines-co/basic-memory

Skill Claude CodeCodex

Structured metadata search for Basic Memory: query notes by custom frontmatter fields using equality, range, array, and nested filters. Use when finding notes by status, priority, confidence, or any custom YAML field rather than free-text content.

basicmachines-co/basic-memory

Skill Claude CodeCodex

How to write well-structured Basic Memory notes: frontmatter, observations with semantic categories, relations with wiki-links, and best practices for building a rich knowledge graph. Use when creating or improving notes.

basicmachines-co/basic-memory

Skill Claude CodeCodex

Guide someone new to Basic Memory through designing and building a complete personal knowledge system — interview them about what they want to track, propose a structure, build it with schemas and instruction notes, teach them to use it, and set up their AI assistant to load it automatically. Use this skill whenever a…