Claude Code-specific plugins for Basic Memory knowledge management.

This repository uses Claude Code's plugin format — skills and hooks bundled into an installable marketplace. It only works with Claude Code.

Looking for framework-agnostic skills? See basic-memory-skills — SKILL.md files that work in Claude Code, Claude Desktop, and other MCP-compatible agents. Some functionality (commands, hooks) is unique to this Claude Code plugin and isn't available there.

Add the marketplace and install the plugin:

/plugin marketplace add basicmachines-co/basic-memory-plugins
/plugin install basic-memory@basicmachines-co

Skills and hooks for Basic Memory MCP server integration.

Skills:

• placement - Decide which folder a new note belongs in (runs automatically before write_note)
• knowledge-capture - Capture important information from conversations
• continue-conversation - Continue previous conversations with context
• knowledge-organize - Maintain and organize the knowledge graph
• research - Research topics using web search and save to memory
• edit-note - Edit existing notes in the knowledge base

Skills auto-expose as slash commands in Claude Code (e.g., /knowledge-organize). The Basic Memory MCP server provides additional prompts (continue_conversation, recent_activity, search) that surface as their own slash commands.

Hooks:

• Pre-write placement (selects the right folder based on project conventions)
• Post-write confirmation

The plugin reads conventions from a unified config file:

• Per-project: a note titled basic-memory at the project root
• Global: ~/.basic-memory/basic-memory.md

Sections (## Projects, ## Placements, ## Formats, ## Schemas) define rules. H3 sub-sections (e.g. ### research) provide project-specific overrides.

If no config exists, the plugin uses sensible built-in defaults. See PLUGIN.md for the full schema and a bootstrap walkthrough.

• Basic Memory MCP server must be configured
• Claude Code CLI

See PLUGIN.md for full documentation.

MIT