mirror of
https://github.com/basicmachines-co/basic-memory
synced 2026-06-21 13:47:35 +00:00
phernandez
9c3d2eb335
Reorganize plugin files into a dedicated subdirectory to keep them separate from the main Basic Memory Python package: - Move all plugin files to claude-code-plugin/ - Add README.md with quick start guide - Update installation paths to use subdirectory New structure: ``` claude-code-plugin/ ├── .claude-plugin/ │ ├── plugin.json │ └── marketplace.json ├── commands/ ├── skills/ ├── hooks/ ├── README.md └── PLUGIN.md ``` Installation: /plugin marketplace add basicmachines-co/basic-memory/claude-code-plugin /plugin install basic-memory@basicmachines 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: phernandez <paul@basicmachines.co>
Basic Memory Plugin for Claude Code
A Claude Code plugin that integrates Basic Memory - a local-first knowledge management system built on the Model Context Protocol (MCP).
What This Plugin Does
This plugin helps Claude Code work seamlessly with your Basic Memory knowledge base:
- Capture knowledge from conversations automatically
- Resume previous work by building context from your knowledge graph
- Edit notes interactively through conversation
- Organize your knowledge by finding orphans, suggesting links, and maintaining structure
Installation
1. Install Basic Memory
pip install basic-memory
# or
pipx install basic-memory
2. Add the Marketplace
/plugin marketplace add basicmachines-co/basic-memory/claude-code-plugin
3. Install the Plugin
/plugin install basic-memory@basicmachines
Commands
| Command | Description |
|---|---|
/remember [title] |
Capture insights from the current conversation |
/continue [topic] |
Resume previous work with context |
/context <memory://url> |
Build context from a specific note |
/recent [timeframe] |
Show recent activity |
/organize [action] |
Maintain your knowledge graph |
Examples
# Capture what we just discussed
/remember "Database Design Decision"
# Pick up where we left off
/continue postgres migration
# Check recent changes
/recent 1week
# Find orphan notes and suggest links
/organize orphans
Skills
Skills are model-invoked - Claude uses them automatically when the context fits.
| Skill | What It Does |
|---|---|
knowledge-capture |
Auto-captures decisions and insights into structured notes |
continue-conversation |
Builds context when resuming previous work |
spec-driven-development |
Guides implementation based on specs in Basic Memory |
edit-note |
Edits notes via MCP tools (cloud-compatible) |
edit-note-local |
Edits notes as files (local installations) |
knowledge-organize |
Helps organize and link notes |
Hooks
| Event | Behavior |
|---|---|
PostToolUse: write_note |
Confirms when notes are saved |
Stop |
Suggests capturing valuable insights after conversations |
Requirements
- Claude Code
- Basic Memory with MCP server configured
Documentation
License
MIT - See the Basic Memory repository for details.