Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions plugins/obsidian-memory/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
{
"name": "obsidian-memory",
"description": "Long-term memory for Claude — remembers preferences, decisions, and project context across sessions using an Obsidian vault",
"version": "1.0.0",
"author": {
"name": "MSApps",
"url": "https://msapps.mobi"
},
"license": "MIT",
"keywords": [
"obsidian",
"memory",
"context",
"preferences",
"sessions",
"sosa-agents"
],
"platforms": [
"claude-code",
"cowork"
],
"sosa": {
"compliant": true,
"level": 2,
"impact": "medium",
"methodology": "https://github.com/MSApps-Mobile/claude-plugins/blob/main/docs/SOSA.md",
"whitepaper": "https://github.com/MSApps-Mobile/claude-plugins/blob/main/docs/sosa-whitepaper.pdf",
"pillars": {
"supervised": "User controls what gets stored — all files are local Markdown",
"orchestrated": "Structured vault folders with cross-session retrieval",
"secured": "Local filesystem only, no external APIs, user owns all data",
"agents": "R=long-term-memory, T=filesystem, M=obsidian-vault, P=store-retrieve-update"
}
},
"topics": [
"sosa-agents"
]
}
47 changes: 47 additions & 0 deletions plugins/obsidian-memory/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
# Obsidian Memory

Give Claude long-term memory across sessions using a local Obsidian vault. Remember preferences, track decisions, archive session summaries, and store quick facts.

## Available Skills

- **Remember** — Store preferences, tools, communication style, and project context
- **Recall** — Retrieve stored knowledge about the user, projects, or past decisions
- **Archive** — Save session summaries for seamless handoffs between sessions
- **Forget** — Remove outdated or incorrect information on command

## Memory Structure

All memory lives in the user's Obsidian vault as Markdown files, organized into existing vault folders:

- **Preferences/** — User preferences, communication style, tools, workflow
- **Projects/** — One file per active project with context and status
- **People/** — Key contacts and collaborators
- **Daily/** — Daily notes including session summaries and decisions
- **Claude Memory/** — Claude-specific storage (decisions log, quick facts, session archive)

## How It Works

Unlike the Notion Memory plugin which requires an MCP connector, this plugin operates directly on local Markdown files using Claude's built-in filesystem tools (Read, Write, Edit, Glob, Grep). No external API or connector is needed.

## Configuration

Set the vault path in the skill or detect it automatically. Default: `~/Library/CloudStorage/GoogleDrive-*/My Drive/Obsidian Vault/*/`

## Common Workflows

- "Remember I prefer dark mode" → stores preference in Preferences/
- "What do you know about BPure?" → searches vault for BPure references
- "Save what we did today" → appends to today's Daily note + session archive
- "Forget my old email" → removes outdated fact
- "Log the decision to use React" → adds to Claude Memory/Decisions Log

## Best Practices

- Leverage existing vault structure — don't duplicate what's already there
- Store information immediately when the user shares a preference or makes a decision
- Always check relevant vault files at the start of a session
- Keep Quick Facts concise — one line per fact
- When recalling, search across all vault folders using Grep
- Update rather than duplicate when information changes
- Respect "forget" commands — fully remove the information
- Use Obsidian-compatible Markdown (support `[[wiki-links]]` and YAML frontmatter)
75 changes: 75 additions & 0 deletions plugins/obsidian-memory/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# Obsidian Memory — Claude Plugin by MSApps

Give Claude long-term memory across sessions using your local Obsidian vault. Claude remembers your preferences, decisions, project context, and session history — all stored as plain Markdown files you own.

## What it does

- **Remembers** preferences, tools, communication style
- **Tracks** decisions with reasoning and dates
- **Archives** session summaries for seamless handoffs
- **Stores** quick facts and project context
- **Forgets** on command — you're always in control

## How it works

Memory is stored as Markdown files in your Obsidian vault, organized into folders:

- **Preferences/** — who you are, how you work
- **Projects/** — one file per active project
- **People/** — key contacts and collaborators
- **Daily/** — daily notes with session summaries
- **Claude Memory/** — decisions log, quick facts, session archive

Unlike the Notion-based memory plugin, this works entirely on the local filesystem — no external API or connector required.

## Installation

**Claude Code (CLI):**
```bash
/plugin marketplace add MSApps-Mobile/claude-plugins
/plugin install obsidian-memory@msapps-plugins
```

**Cowork:**
1. Settings → Plugins → Marketplaces → Add → `MSApps-Mobile/claude-plugins`
2. Search "obsidian-memory" → Install

## Requirements

- An **Obsidian vault** accessible on the local filesystem
- Claude Code or Cowork with filesystem access to the vault directory

## Configuration

The plugin auto-detects common Obsidian vault locations. If your vault is in a non-standard location, set the path in the skill configuration.

## Usage

Just talk to Claude naturally:

- "Remember that I prefer dark mode"
- "What do you know about the BPure project?"
- "Save what we did today"
- "Forget my old email address"

Claude also saves context automatically when it detects preferences, decisions, or project info.

## Advantages over Notion Memory

| Feature | Obsidian Memory | Notion Memory |
|---------|----------------|---------------|
| Requires external API | No | Yes (Notion MCP) |
| Data location | Local files | Cloud (Notion) |
| Works offline | Yes | No |
| File format | Plain Markdown | Notion blocks |
| User can edit directly | Yes (any text editor) | Yes (Notion app) |
| Supports wiki-links | Yes | No |
| Backlinks & graph view | Yes (via Obsidian) | No |

## License

MIT — Free and open source.

## Author

**MSApps** — [msapps.mobi](https://msapps.mobi) | [michal@msapps.mobi](mailto:michal@msapps.mobi)
Loading