mirror of
https://github.com/basicmachines-co/basic-memory
synced 2026-06-21 13:47:35 +00:00
phernandez
4bfec8a88e
New capability to research topics and save structured reports: /research command: - /research <topic> [folder] - Investigates using web search, codebase search, and existing notes - Produces structured report with findings and analysis - Saves to research/ folder by default research skill (model-invoked): - Triggers on "research", "investigate", "look into", "explore" - Gathers information from multiple sources - Synthesizes findings into actionable reports - Links to sources and related notes Report structure: - Summary and research question - Key findings with evidence - Analysis and recommendations - Open questions and sources - Observations and relations for knowledge graph 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: phernandez <paul@basicmachines.co>
101 lines
2.8 KiB
Markdown
101 lines
2.8 KiB
Markdown
# 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 |
|
|
| `/research <topic>` | Research a topic and save a report |
|
|
|
|
### 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
|
|
|
|
# Research a topic and save findings
|
|
/research "MCP protocol"
|
|
```
|
|
|
|
## 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 |
|
|
| `research` | Researches topics and produces saved reports |
|
|
|
|
## 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.
|