refactor: Move plugin into claude-code-plugin subdirectory

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>
This commit is contained in:
phernandez
2025-11-28 14:08:29 -06:00
parent 5fcbae3fdb
commit 9c3d2eb335
16 changed files with 101 additions and 4 deletions
+6 -4
View File
@@ -21,7 +21,7 @@ Then add it to your Claude Code MCP configuration.
### Add the Marketplace
```
/plugin marketplace add basicmachines-co/basic-memory
/plugin marketplace add basicmachines-co/basic-memory/claude-code-plugin
```
### Install the Plugin
@@ -41,7 +41,8 @@ Add to your `.claude/settings.json`:
"basicmachines": {
"source": {
"source": "github",
"repo": "basicmachines-co/basic-memory"
"repo": "basicmachines-co/basic-memory",
"path": "claude-code-plugin"
}
}
},
@@ -243,7 +244,7 @@ This plugin leverages Basic Memory's MCP tools:
## Plugin Structure
```
basic-memory/
claude-code-plugin/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Self-hosted marketplace
@@ -262,7 +263,8 @@ basic-memory/
│ └── knowledge-organize/
├── hooks/
│ └── hooks.json # Hook definitions
── PLUGIN.md # This file
── README.md # Quick start guide
└── PLUGIN.md # Full documentation
```
---
+95
View File
@@ -0,0 +1,95 @@
# Basic Memory Plugin for Claude Code
A Claude Code plugin that integrates [Basic Memory](https://basicmemory.io) - 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
```bash
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
```bash
# 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](https://claude.com/claude-code)
- [Basic Memory](https://basicmemory.io) with MCP server configured
## Documentation
- [Full Plugin Documentation](./PLUGIN.md)
- [Basic Memory Docs](https://docs.basicmemory.io)
- [Claude Code Plugins](https://code.claude.com/docs/en/plugins)
## License
MIT - See the [Basic Memory repository](https://github.com/basicmachines-co/basic-memory) for details.