claude-mnemo

Persistent memory layer for Claude Code — your Obsidian vault on autopilot.

What It Does

mnemo gives Claude Code a persistent memory through your Obsidian vault. Eight skills that handle the boring parts of knowledge management so you can focus on thinking.

Most "second brain" tools assume you have time to organize. mnemo assumes you don't.

You work → mnemo remembers → Your vault grows → You find things later

The Skills

Skill	Command	What it does
health	`/mn:health`	Vault audit: orphans, broken links, missing sections, stale notes, growth stats
ask	`/mn:ask`	Search vault and synthesize answers from multiple notes with citations
connect	`/mn:connect`	Discover hidden connections between notes you'd never think of
sort	`/mn:sort`	Classify inbox notes into proper types (atom, molecule, source...)
session	`/mn:session`	Auto-generate session summary + cross-session handoff
save	`/mn:save`	Memory routing cascade — Obsidian + claude-mem + memory/ with graceful degradation
review	`/mn:review`	End-of-session orchestrator — auto-saves decisions, creates session notes, recommends remaining skills
setup	`/mn:setup`	Interactive onboarding — vault name, taxonomy, language

Why Not Just Use Obsidian Plugins?

Obsidian plugins run inside Obsidian. mnemo runs inside Claude Code — it has access to your entire development context, conversation history, and codebase. When you finish a 3-hour debugging session, /mn:session knows what you did because it was there.

What's New in v0.5

/mn:review is now your end-of-session orchestrator. Just run it and it handles everything:

Auto-saves unsaved decisions and findings to Obsidian + claude-mem + memory/
Auto-creates session notes with handoff for the next session
Parses your session's JSONL file to know exactly which tools and skills were used
Auto-discovers 200+ installed skills across all your plugins
Classifies your session type (implementation, research, debugging...)
Recommends remaining skills (commit, connect, health) — you pick which to run

One command to end any session: /mn:review

Architecture

┌──────────────┐     ┌───────────────┐     ┌───────────────┐
│  Claude Code  │────▶│    commands    │────▶│    skills      │
│  (you type    │     │  /mn:save     │     │  memory-routing │
│   /mn:save)   │     │  /mn:review   │     │  session-review │
└──────────────┘     └───────────────┘     └───────────────┘
                            │                      │
                            │                ┌─────▼─────┐
                            │                │ Obsidian   │
                            │                │ CLI        │
                            │                └───────────┘
                      ~/.mnemo/config.json

Commands are thin wrappers that route to skills via the Skill tool. This separation follows the compound-engineering pattern: short command names (/mn:*) with a descriptive plugin label (mnemo).

Key design decisions:

CLI-first — uses obsidian CLI commands, not MCP (70,000x cheaper)
Config-driven — vault name, taxonomy, rules in config.json
Non-destructive — skills report and suggest, never auto-delete or overwrite
Any taxonomy — works with Zettelkasten, PARA, Atom/Molecule, or your own system

Quick Start

Install

# Add marketplace (one time)
claude plugin marketplace add jojoprison/claude-mnemo

# Install plugin
claude plugin install mnemo@claude-mnemo

First Run

/mn:health
> What's your Obsidian vault name? main
> Saved to config.json. Running health check...

Usage Examples

Weekly vault checkup

/mn:health

📊 Vault Health Report (2026-04-07)

Total: 487 notes
  Atoms: 89 | Molecules: 23 | Sources: 34
  Sessions: 67 | MOCs: 14 | Inbox: 4

🔴 Orphans: 3
📬 Inbox backlog: 4 notes
🏆 Top-5 Hubs: MOC — Security (34), MOC — AI ML Tools (28)...

Search your knowledge base

/mn:ask "what did we decide about pricing strategy?"

Returns synthesized answers with citations to specific notes.

Discover hidden links

/mn:connect "Atom — LongCat-Flash-Prover"

Finds notes related by concepts, tags, or entities — then asks before applying.

Save decisions and findings

/mn:save "We chose PostgreSQL over DynamoDB for the audit log — better JSON querying"

Routes to Obsidian (Atom note) + claude-mem (semantic search) + memory/ (Claude's future context). If any backend is down, the others still work.

End-of-session orchestrator (the only command you need)

/mn:review

Analyzes your session, auto-saves decisions, auto-creates session notes. Then asks about remaining skills (commit, connect, health).

Session notes + handoff

/mn:session

Creates a session summary in Obsidian, updates the handoff file for the next session. No more "what was I doing yesterday?"

Configuration

Run /mn:setup or copy manually:

mkdir -p ~/.mnemo
cp config.example.json ~/.mnemo/config.json

{
  "vault": "main",
  "taxonomy": {
    "atom": { "prefix": "Atom — ", "tag": "atom" },
    "molecule": { "prefix": "Molecule — ", "tag": "molecule" },
    "source": { "prefix": "Source — ", "tag": "source" },
    "session": { "prefix": "Session — ", "tag": "session" },
    "moc": { "prefix": "MOC — ", "tag": "moc" },
    "inbox": { "prefix": "Inbox — ", "tag": "inbox" }
  },
  "links_section": "## Links",
  "handoff_note": "Meta — Session Handoff",
  "cascade": {
    "obsidian": { "enabled": true },
    "claude_mem": { "enabled": true },
    "memory_dir": { "enabled": true }
  }
}

All fields are optional. Skills ask on first use.

Custom Taxonomy

mnemo doesn't force a note structure. Change taxonomy to match yours:

{
  "taxonomy": {
    "permanent": { "prefix": "", "tag": "permanent" },
    "fleeting": { "prefix": "F: ", "tag": "fleeting" },
    "literature": { "prefix": "L: ", "tag": "literature" }
  }
}

Cross-Session Continuity

The killer feature. When a session ends, /mn:session writes a handoff note:

## Pending
- [ ] Check orphans after mass note creation
- [ ] Update MOC — AI Research with 3 new notes

## Context
- Researched WeChat agent ecosystem, all saved in Session — 2026-03-23

Next session reads this and picks up where you left off.

Requirements

Claude Code (Pro/Max/Team or API key)
Obsidian (free) — must be running
Obsidian CLI — obsidian command in PATH

Project Structure

claude-mnemo/
├── plugins/mnemo/
│   ├── .claude-plugin/plugin.json
│   ├── commands/mn/                 # User-facing /mn:* commands
│   │   ├── save.md                  # /mn:save → mnemo:memory-routing
│   │   ├── session.md               # /mn:session → mnemo:session-notes
│   │   ├── review.md                # /mn:review → mnemo:session-review
│   │   ├── ask.md                   # /mn:ask → mnemo:vault-search
│   │   ├── health.md                # /mn:health → mnemo:vault-health
│   │   ├── connect.md               # /mn:connect → mnemo:link-discovery
│   │   ├── sort.md                  # /mn:sort → mnemo:inbox-triage
│   │   └── setup.md                 # /mn:setup → mnemo:initial-setup
│   └── skills/                      # Skill implementations
│       ├── memory-routing/SKILL.md
│       ├── session-notes/SKILL.md
│       ├── session-review/SKILL.md
│       ├── vault-search/SKILL.md
│       ├── vault-health/SKILL.md
│       ├── link-discovery/SKILL.md
│       ├── inbox-triage/SKILL.md
│       └── initial-setup/SKILL.md
├── config.example.json
├── CONTRIBUTING.md
├── CHANGELOG.md
└── LICENSE

Inspired By

My-Brain-Is-Full-Crew — 8 AI agents managing Obsidian. Great concept, different approach: PARA-based, heavier. mnemo takes the best ideas and packages them as lightweight skills for any vault.
kepano/obsidian-cli + obsidian-skills — CLI-first philosophy and the 70,000x token savings insight.
Zettelkasten, Atomic/Molecular Notes, Maps of Content — note taxonomy research.

Contributing

PRs welcome. If you have a better prompt pattern, a new skill idea, or a taxonomy adapter — open a PR.

Русский

Что делает

mnemo дает Claude Code постоянную память через Obsidian vault. Восемь скиллов, которые берут на себя рутину управления знаниями.

Большинство инструментов «второго мозга» предполагают, что у тебя есть время все организовать. mnemo предполагает, что нет.

Ты работаешь → mnemo запоминает → Vault растет → Ты находишь потом

Скиллы

Скилл	Команда	Что делает
health	`/mn:health`	Аудит vault: orphans, битые ссылки, пропущенные секции, стагнирующие заметки
ask	`/mn:ask`	Поиск по vault и синтез ответа из нескольких заметок с цитатами
connect	`/mn:connect`	Находит скрытые связи между заметками
sort	`/mn:sort`	Классификация inbox-заметок в типы (atom, molecule, source...)
session	`/mn:session`	Сессионная заметка + cross-session handoff
save	`/mn:save`	Каскадное сохранение — Obsidian + claude-mem + memory/
review	`/mn:review`	Оркестратор конца сессии — автосохраняет решения, создает session notes, рекомендует оставшиеся скиллы
setup	`/mn:setup`	Интерактивный онбординг

Почему не обычные плагины Obsidian?

Плагины Obsidian работают внутри Obsidian. mnemo работает внутри Claude Code — у него есть доступ ко всему контексту разработки, истории разговора и кодовой базе. Когда ты заканчиваешь 3-часовую сессию, /mn:session знает что ты делал, потому что был рядом.

Что нового в v0.5

/mn:review — теперь оркестратор конца сессии. Одна команда — и всё:

Автосохранение решений и находок в Obsidian + claude-mem + memory/
Автосоздание session notes с handoff для следующей сессии
Парсит JSONL — знает какие инструменты и скиллы были вызваны
Автообнаружение 200+ скиллов по всем плагинам
Определяет тип сессии (implementation, research, debugging...)
Рекомендует оставшееся (commit, connect, health) — ты выбираешь

Одна команда для завершения сессии: /mn:review

Установка

# Добавить marketplace (один раз)
claude plugin marketplace add jojoprison/claude-mnemo

# Установить плагин
claude plugin install mnemo@claude-mnemo

Первый запуск

/mn:health
> Как называется твой Obsidian vault? main
> Сохранено. Запускаю проверку...

Примеры

Аудит vault

/mn:health

📊 Здоровье Vault (2026-04-07)

Всего: 487 заметок
  Atoms: 89 | Molecules: 23 | Sources: 34

🔴 Orphans: 3
📬 Inbox: 4 заметки
🏆 Топ-5 хабов: MOC — Security (34), MOC — AI ML Tools (28)...

Поиск по знаниям

/mn:ask "что мы решили по ценообразованию?"

Синтезирует ответ из нескольких заметок с цитатами и ссылками.

Скрытые связи

/mn:connect "Atom — LongCat-Flash-Prover"

Находит связи по концептам, тегам, сущностям. Спрашивает перед применением.

Сохранение решений

/mn:save "Выбрали PostgreSQL вместо DynamoDB для audit log — лучше JSON querying"

Роутит в Obsidian (Atom) + claude-mem (семантический поиск) + memory/ (контекст для Claude). Если backend упал — остальные работают.

Ревью сессии (единственная команда на конец)

/mn:review

Анализирует сессию, автоматически сохраняет решения и создает session notes. Потом спрашивает про остальное (commit, connect, health).

Сессионные заметки

/mn:session

Создает заметку в Obsidian, обновляет handoff для следующей сессии.

Конфигурация

/mn:setup или вручную:

mkdir -p ~/.mnemo
cp config.example.json ~/.mnemo/config.json

Все поля опциональны. Скиллы спросят при первом запуске.

Cross-Session Continuity

Киллер-фича. /mn:session записывает handoff-заметку. Следующая сессия подхватывает с того места. Больше никакого «а что я вчера делал?»

Требования

Claude Code (Pro/Max/Team или API ключ)
Obsidian (бесплатно) — должен быть запущен
Obsidian CLI — obsidian в PATH

中文

功能介绍

mnemo 为 Claude Code 提供基于 Obsidian 的持久记忆层。八个技能自动处理知识管理的繁琐工作，让你专注于思考。

大多数「第二大脑」工具假设你有时间整理。mnemo 假设你没有。

你工作 → mnemo 记住 → Vault 成长 → 你以后能找到

技能列表

技能	命令	功能
health	`/mn:health`	Vault 审计：孤立笔记、断链、缺失章节、陈旧笔记、增长统计
ask	`/mn:ask`	搜索 vault 并从多个笔记中综合答案，附带引用
connect	`/mn:connect`	发现笔记之间隐藏的联系
sort	`/mn:sort`	将收件箱笔记分类为正确类型（atom、molecule、source...）
session	`/mn:session`	自动生成会话摘要 + 跨会话上下文传递
save	`/mn:save`	级联保存 — Obsidian + claude-mem + memory/，优雅降级
review	`/mn:review`	会话结束编排器 — 自动保存决策、创建会话笔记、推荐其余技能
setup	`/mn:setup`	交互式引导配置

为什么不用 Obsidian 插件？

Obsidian 插件在 Obsidian 内部运行。mnemo 在 Claude Code 内部运行——它可以访问你的整个开发上下文、对话历史和代码库。当你结束一个 3 小时的调试会话时，/mn:session 知道你做了什么，因为它全程在场。

v0.5 新特性

/mn:review 现在是会话结束编排器。一个命令搞定一切：

自动保存未持久化的决策和发现到 Obsidian + claude-mem + memory/
自动创建会话笔记和交接文件
解析 JSONL 文件，精确知道使用了哪些工具和技能
自动发现 200+ 已安装技能
识别会话类型（实现、研究、调试...）
推荐其余技能（commit、connect、health）——你选择运行哪些

结束会话只需一个命令：/mn:review

安装

# 添加市场（一次性）
claude plugin marketplace add jojoprison/claude-mnemo

# 安装插件
claude plugin install mnemo@claude-mnemo

首次运行

/mn:health
> 你的 Obsidian vault 名称是？ main
> 已保存。正在运行健康检查...

使用示例

Vault 审计

/mn:health

📊 Vault 健康报告 (2026-04-07)

总计：487 个笔记
  Atoms: 89 | Molecules: 23 | Sources: 34

🔴 孤立笔记：3
📬 收件箱：4 个笔记待分类
🏆 前5大枢纽：MOC — Security (34), MOC — AI ML Tools (28)...

知识搜索

/mn:ask "我们对定价策略做了什么决定？"

从多个笔记中综合答案，附带引用和链接。

发现隐藏联系

/mn:connect "Atom — LongCat-Flash-Prover"

通过概念、标签、实体找到关联。应用前会询问确认。

保存决策

/mn:save "选择了 PostgreSQL 而不是 DynamoDB 用于审计日志——JSON 查询更好"

路由到 Obsidian（Atom 笔记）+ claude-mem（语义搜索）+ memory/（Claude 的未来上下文）。任何后端宕机，其他仍然工作。

会话审查（会话结束只需这一个命令）

/mn:review

分析会话，自动保存决策并创建会话笔记。然后询问其余操作（commit、connect、health）。

会话笔记

/mn:session

在 Obsidian 中创建会话摘要，更新下次会话的交接文件。

配置

/mn:setup 或手动：

mkdir -p ~/.mnemo
cp config.example.json ~/.mnemo/config.json

所有字段可选。技能会在首次使用时询问。

跨会话连续性

杀手级功能。/mn:session 写入交接笔记，下次会话自动接续。再也不用问「我昨天在做什么？」

环境要求

Claude Code（Pro/Max/Team 或 API 密钥）
Obsidian（免费）——必须运行中
Obsidian CLI——obsidian 命令在 PATH 中

Made with care by Claude Code + jojoprison

Claude Mnemo

claude-mnemo

What It Does

The Skills

Why Not Just Use Obsidian Plugins?

What's New in v0.5

Architecture

Quick Start

Install

First Run

Usage Examples

Weekly vault checkup

Search your knowledge base

Discover hidden links

Save decisions and findings

End-of-session orchestrator (the only command you need)

Session notes + handoff

Configuration

Custom Taxonomy

Cross-Session Continuity

Requirements

Project Structure

Inspired By

Contributing

Русский

Что делает

Скиллы

Почему не обычные плагины Obsidian?

Что нового в v0.5

Установка

Первый запуск

Примеры

Аудит vault

Поиск по знаниям

Скрытые связи

Сохранение решений

Ревью сессии (единственная команда на конец)

Сессионные заметки

Конфигурация

Cross-Session Continuity

Требования

中文

功能介绍

技能列表

为什么不用 Obsidian 插件？

v0.5 新特性

安装

首次运行

使用示例

Vault 审计

知识搜索

发现隐藏联系

保存决策

会话审查（会话结束只需这一个命令）

会话笔记

配置

跨会话连续性

环境要求