basicmachines-co-basic-memory/plugins/claude-code

Basic Memory Claude Code Plugin

Claude Code-specific plugins for Basic Memory knowledge management.

This package lives in the canonical basic-memory repository under plugins/claude-code/. It 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 the top-level skills/ directory — 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.

Installation

Add the marketplace and install the plugin:

claude plugin marketplace add basicmachines-co/basic-memory --sparse .claude-plugin plugins/claude-code
claude plugin install basic-memory@basicmachines-co

Available Plugins

basic-memory

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

Configuration

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.

Requirements

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

Development

From the monorepo root:

just package-check-claude-code

From this directory:

just check

just check validates the root marketplace, plugin-local manifests, bundled skills, hooks, and basic-memory-manager agent, then runs claude plugin validate . --strict.

Documentation

See PLUGIN.md for full documentation.

License

MIT