Skip to content

Commit 9c3d2eb

Browse files
phernandezclaude
andcommitted
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>
1 parent 5fcbae3 commit 9c3d2eb

16 files changed

Lines changed: 101 additions & 4 deletions

File tree

File renamed without changes.
File renamed without changes.

PLUGIN.md renamed to claude-code-plugin/PLUGIN.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Then add it to your Claude Code MCP configuration.
2121
### Add the Marketplace
2222

2323
```
24-
/plugin marketplace add basicmachines-co/basic-memory
24+
/plugin marketplace add basicmachines-co/basic-memory/claude-code-plugin
2525
```
2626

2727
### Install the Plugin
@@ -41,7 +41,8 @@ Add to your `.claude/settings.json`:
4141
"basicmachines": {
4242
"source": {
4343
"source": "github",
44-
"repo": "basicmachines-co/basic-memory"
44+
"repo": "basicmachines-co/basic-memory",
45+
"path": "claude-code-plugin"
4546
}
4647
}
4748
},
@@ -243,7 +244,7 @@ This plugin leverages Basic Memory's MCP tools:
243244
## Plugin Structure
244245

245246
```
246-
basic-memory/
247+
claude-code-plugin/
247248
├── .claude-plugin/
248249
│ ├── plugin.json # Plugin manifest
249250
│ └── marketplace.json # Self-hosted marketplace
@@ -262,7 +263,8 @@ basic-memory/
262263
│ └── knowledge-organize/
263264
├── hooks/
264265
│ └── hooks.json # Hook definitions
265-
└── PLUGIN.md # This file
266+
├── README.md # Quick start guide
267+
└── PLUGIN.md # Full documentation
266268
```
267269

268270
---

claude-code-plugin/README.md

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
# Basic Memory Plugin for Claude Code
2+
3+
A Claude Code plugin that integrates [Basic Memory](https://basicmemory.io) - a local-first knowledge management system built on the Model Context Protocol (MCP).
4+
5+
## What This Plugin Does
6+
7+
This plugin helps Claude Code work seamlessly with your Basic Memory knowledge base:
8+
9+
- **Capture knowledge** from conversations automatically
10+
- **Resume previous work** by building context from your knowledge graph
11+
- **Edit notes** interactively through conversation
12+
- **Organize your knowledge** by finding orphans, suggesting links, and maintaining structure
13+
14+
## Installation
15+
16+
### 1. Install Basic Memory
17+
18+
```bash
19+
pip install basic-memory
20+
# or
21+
pipx install basic-memory
22+
```
23+
24+
### 2. Add the Marketplace
25+
26+
```
27+
/plugin marketplace add basicmachines-co/basic-memory/claude-code-plugin
28+
```
29+
30+
### 3. Install the Plugin
31+
32+
```
33+
/plugin install basic-memory@basicmachines
34+
```
35+
36+
## Commands
37+
38+
| Command | Description |
39+
|---------|-------------|
40+
| `/remember [title]` | Capture insights from the current conversation |
41+
| `/continue [topic]` | Resume previous work with context |
42+
| `/context <memory://url>` | Build context from a specific note |
43+
| `/recent [timeframe]` | Show recent activity |
44+
| `/organize [action]` | Maintain your knowledge graph |
45+
46+
### Examples
47+
48+
```bash
49+
# Capture what we just discussed
50+
/remember "Database Design Decision"
51+
52+
# Pick up where we left off
53+
/continue postgres migration
54+
55+
# Check recent changes
56+
/recent 1week
57+
58+
# Find orphan notes and suggest links
59+
/organize orphans
60+
```
61+
62+
## Skills
63+
64+
Skills are model-invoked - Claude uses them automatically when the context fits.
65+
66+
| Skill | What It Does |
67+
|-------|--------------|
68+
| `knowledge-capture` | Auto-captures decisions and insights into structured notes |
69+
| `continue-conversation` | Builds context when resuming previous work |
70+
| `spec-driven-development` | Guides implementation based on specs in Basic Memory |
71+
| `edit-note` | Edits notes via MCP tools (cloud-compatible) |
72+
| `edit-note-local` | Edits notes as files (local installations) |
73+
| `knowledge-organize` | Helps organize and link notes |
74+
75+
## Hooks
76+
77+
| Event | Behavior |
78+
|-------|----------|
79+
| `PostToolUse: write_note` | Confirms when notes are saved |
80+
| `Stop` | Suggests capturing valuable insights after conversations |
81+
82+
## Requirements
83+
84+
- [Claude Code](https://claude.com/claude-code)
85+
- [Basic Memory](https://basicmemory.io) with MCP server configured
86+
87+
## Documentation
88+
89+
- [Full Plugin Documentation](./PLUGIN.md)
90+
- [Basic Memory Docs](https://docs.basicmemory.io)
91+
- [Claude Code Plugins](https://code.claude.com/docs/en/plugins)
92+
93+
## License
94+
95+
MIT - See the [Basic Memory repository](https://github.com/basicmachines-co/basic-memory) for details.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)