mnemo

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

What It Does

mnemo gives Codex and Claude Code a persistent memory through your Obsidian vault. Seven skills 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

Invocation: Claude Code uses exact commands such as /mn:save. Codex shows the same mn:save label in its skill picker, while the deterministic explicit invocation is $mnemo:save (type $ or open /skills). Examples below use Claude syntax unless marked otherwise.

The Skills

Skill	Command	What it does
save	`/mn:save`	Routing cascade — sends recall to Obsidian (+ optional claude-mem and enabled Claude auto-memory); Codex generated memory stays read-only. Actionable project-rule routing is separate
session	`/mn:session`	Session summary note + cross-session handoff for the next session
review	`/mn:review`	End-of-session orchestrator — audits the session, recommends save + session + the rest, asks before running anything
ask	`/mn:ask`	Search the vault + active runtime memory (+ optional verified counterpart memory), synthesize a cited answer, date sources, and ground current-state answers in git history
connect	`/mn:connect`	Discover hidden connections between notes — suggests, never auto-applies
health	`/mn:health`	Vault audit: orphans, broken links, type-aware review candidates (+ optional LLM lint), growth stats
setup	`/mn:setup`	Interactive onboarding — vault, taxonomy, language, optional cross-runtime recall

When to Use Which

Moment	Command
The instant a fact/decision/finding appears, mid-session	`/mn:save` — save as you go, don't batch (compaction can drop context at any time)
Recall earlier context / past decisions	`/mn:ask`
Just created notes — surface hidden links	`/mn:connect`
End of work, or before a long run risks context compaction	`/mn:session` — writes the journey note + handoff
One command to close a session	`/mn:review` — audits + recommends save & session & the rest (one confirmation)
Periodically / after 3+ new notes	`/mn:health`

save and session are complementary, not either/or: save pins discrete facts as they happen; session writes the narrative + handoff at the end. review orchestrates both — but only with your confirmation, so the loss-proof habit is save throughout plus an explicit session/review at the end.

Why Not Just Use Obsidian Plugins?

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

Highlights

Cross-runtime recall without synchronization (v1.2.3) — opt-in recall.runtimeMemory lets Codex see verified Claude project memory and Claude see project-scoped Codex memory. It is a bounded read-only overlay: exact git-repository proof, no transcript scan, symlink, shared writer, mirror, daemon, or duplicate store. Obsidian remains authoritative; native memory is cited as untrusted secondary evidence.
One canonical surface across Claude Code and Codex (v1.2.0; Codex hook parsing hardened in v1.2.1; Claude default-hook discovery hardened in v1.2.4) — the same seven implementations now register directly as /mn:* in Claude Code and as $mnemo:* with matching mn:* picker labels in Codex. Legacy command routers and alias skill copies are gone; runtime-composed hooks, portable runtime discovery, private caches, and argv-safe Obsidian access keep both runtimes aligned without duplicated behavior.
Knowledge compounds + self-snoozing lint + research gaps (v0.14.0) — three opt-in, on-philosophy distillations from a full audit of Karpathy's "LLM Wiki" pattern. /mn:ask can fold a real synthesis back into the type mapped by taxonomy_roles.insight (a Molecule in the default taxonomy; sources pre-linked) so explorations accumulate; review.lint.autoStampReviewed lets the lint stamp reviewed: on still-valid notes to close the snooze loop; /mn:health surfaces research-gap candidates (populous topic with no MOC, recurring external with no Source note). All opt-in: a default install writes nothing (the content lint is off), the compounding save is user-confirmed, and the lone auto-write — the reviewed: stamp — only fires once you turn the lint on.
Recall grounded in live code (v0.13.0) — for "is this still true / what changed" questions inside a git project, /mn:ask cross-checks the repo's recent commits and flags any note a newer commit may have outdated. Optional code-knowledge-graph backend via recall.codeGraph (Graphify / Sourcegraph / ast-grep…), off by default.
Recency-aware recall (v0.12.0) — /mn:ask now dates every source it cites (git last-commit when the vault is a repo, else file mtime + reviewed/date frontmatter) and flags an answer that rests on stale notes.
Type-aware review + content lint (v0.11.0) — /mn:health flags stale notes by a per-type budget (review.staleDays) instead of a flat 30 days, with a reviewed: snooze and per-note ttl:; an opt-in LLM lint (review.lint.enabled) re-reads candidates for outdated/contradicting claims — Karpathy's "lint your wiki". Changelog moved to Keep a Changelog v2 + GitHub Releases.
Autodream-aware memory index (v0.10.0–0.10.1; effective-path detection hardened in v1.2.5) — Claude's effective auto-memory MEMORY.md is a lean index: one | File | Read when… | row per topic file, never a paragraph. /mn:health honors CLAUDE_CONFIG_DIR, autoMemoryDirectory, and disable controls before applying the configurable memory.indexWarnKB threshold (default 22). /mn:ask can cite verified runtime-generated memory, but mnemo never edits Codex-owned ${CODEX_HOME:-~/.codex}/memories/ state.
PKM-canon + leaner skill set (v0.9.0) — removed inbox-triage (8 → 7 skills): in an agent-driven flow, typed notes are written directly, so there's nothing to triage. Baked in note-naming rules (# . / .md forbidden), hub notes for short names, and metadataCache-over-CLI-cache for accurate link checks.
Dual-runtime (v0.8.0–0.8.2) — renamed claude-mnemo → mnemo; native Codex support alongside Claude Code from one shared skill set.

Full version-by-version history: CHANGELOG.md.

Architecture

┌─────────────────────┐       ┌────────────────────────┐
│ Claude plugin `mn`  │─/mn:*─┤                        │
└─────────────────────┘       │  7 shared skills       │
                              │  ask · save · session  │────▶ Obsidian + native memory policy
┌─────────────────────┐       │  review · connect      │
│ Codex plugin `mnemo`│─$mnemo:*───────────────────────┤
└─────────────────────┘       │  setup · health        │
                              └───────────┬────────────┘
                                          │
                                  ~/.mnemo/config.json

Both runtimes invoke the same seven canonical skill directories directly. Claude Code derives /mn:* from its runtime namespace; Codex derives $mnemo:* and exposes the shorter mn:* picker labels through agents/openai.yaml. There are no command wrappers, aliases, or forked skill bodies.

Key design decisions:

One shell-free vault path — indexed reads/search still use obsidian CLI (70,000x cheaper) through a shell=False adapter; every Markdown write uses the bundled JSON-stdin, optimistic atomic writer in both runtimes
Config-driven — vault name, taxonomy, rules in config.json
Non-destructive — skills report and suggest, never auto-delete or overwrite
Federated, not synchronized — each runtime keeps its native memory; optional counterpart recall is exact-project, read-only, and fail-closed
Any taxonomy — works with Zettelkasten, PARA, Atom/Molecule, or your own system

→ Full rationale and non-goals (features deliberately not shipped — auto-ingest, web-search imputation, hot.md — each with how to add it): docs/design-decisions.md.

Quick Start

Install: Claude Code

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

# Install plugin
claude plugin install mnemo@mnemo

Legacy installs through jojoprison/claude-mnemo continue to work through the GitHub repository redirect, but new installs should use jojoprison/mnemo.

Install: Codex

codex plugin marketplace add jojoprison/mnemo
codex plugin add mnemo@mnemo

Codex discovers the seven shared skills from plugins/mnemo/skills/. Type $ or open /skills, choose the short mn:* label, or invoke the stable ID directly: $mnemo:ask, $mnemo:save, $mnemo:session, $mnemo:review, $mnemo:connect, $mnemo:setup, $mnemo:health. Codex can also invoke them implicitly from their descriptions. Literal /mn:* commands belong to Claude Code.

First Run

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

Usage Examples

Save decisions and findings (any time, as they happen)

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

Routes a recall item to Obsidian (the type mapped by its semantic role), optional claude-mem, and Claude auto-memory when applicable; routes an actionable rule ("never X / always Y" tied to code) to the existing project-instruction path instead. Codex-owned ${CODEX_HOME:-~/.codex}/memories/ is generated read-only state, never a manual fallback. Each unavailable backend is reported explicitly.

Physical note types are resolved only through the exact five semantic roles fact/insight/source/session/moc. Every target must exist in taxonomy; session → session and moc → moc are required, while the three content roles may intentionally share a type.

End-of-session orchestrator (the one command to close a session)

/mn:review

Analyzes your session, then offers one prioritized list — unsaved decisions (/mn:save), session notes (/mn:session), and the rest (commit, connect, health). Nothing runs without your pick.

Session notes + handoff

/mn:session

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

Search your knowledge base

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

Synthesized answers with citations across the vault and active runtime memory. With recall.runtimeMemory.enabled: true, the other runtime's memory for the exact same git repository joins as bounded read-only evidence — nothing is copied or synchronized.

Discover hidden links

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

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

Weekly vault checkup

/mn:health

📊 Vault Health Report (2026-04-07)

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

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

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" }
  },
  "taxonomy_roles": {
    "fact": "atom",
    "insight": "molecule",
    "source": "source",
    "session": "session",
    "moc": "moc"
  },
  "links_section": "## Links",
  "handoff_note": "Meta — Session Handoff",
  "memory": { "indexWarnKB": 22 },
  "cascade": {
    "obsidian": { "enabled": true },
    "claude_mem": { "enabled": false },
    "memory_dir": { "enabled": true },
    "project_rules": { "enabled": true },
    "claude_md": { "enabled": false }
  },
  "review": {
    "staleDays": { "default": 30, "atom": 60, "molecule": 120, "source": 180, "session": 90, "moc": 365 },
    "lint": { "enabled": false, "maxCandidates": 15, "model": "haiku", "autoStampReviewed": true }
  },
  "recall": {
    "codeGraph": null,
    "runtimeMemory": {
      "enabled": false,
      "globalSources": "explicit",
      "maxHits": 5,
      "maxExcerptBytes": 12288
    }
  }
}

The minimal core is vault, taxonomy, the exact five-key taxonomy_roles map, links_section, and handoff_note; optional sections keep their documented defaults. Every role target must exist, while session → session and moc → moc are required functional self-maps. Skills offer setup when the core is missing or invalid. review.* tunes /mn:health; recall.runtimeMemory is the off-by-default, read-only Claude↔Codex project-memory overlay — see config-schema.md.

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" },
    "session": { "prefix": "Session — ", "tag": "session" },
    "moc": { "prefix": "MOC — ", "tag": "moc" }
  },
  "taxonomy_roles": {
    "fact": "permanent",
    "insight": "permanent",
    "source": "literature",
    "session": "session",
    "moc": "moc"
  }
}

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

The next session reads this and picks up where you left off.

Requirements

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

Project Structure

mnemo/
├── plugins/mnemo/
│   ├── .claude-plugin/plugin.json
│   ├── .codex-plugin/plugin.json
│   ├── skills/                      # Skill implementations (7)
│   │   ├── save/                    # SKILL.md + agents/openai.yaml
│   │   ├── session/
│   │   ├── review/
│   │   ├── ask/
│   │   ├── health/
│   │   ├── connect/
│   │   └── setup/
│   ├── references/                  # Shared docs (progressive disclosure)
│   │   ├── gotchas.md               # Common failures (IPC, stale cache, shell injection)
│   │   ├── config-schema.md         # Full ~/.mnemo/config.json reference
│   │   ├── tool-routing.md          # bundled writer / argv-safe reader rule + rationale
│   │   ├── triggers-implementation.md
│   │   ├── triggers-research.md
│   │   ├── triggers-debugging.md
│   │   └── triggers-universal.md
│   ├── assets/                      # Reusable templates
│   │   └── session-template.md
│   ├── scripts/                     # Shell & Python helpers
│   │   ├── safe-read.py             # argv-safe dynamic reads/index queries (no shell interpolation)
│   │   ├── vault-write.py           # JSON-stdin atomic writes + guarded handoff rotation
│   │   ├── runtime-memory.py         # bounded read-only Claude↔Codex recall adapter
│   │   ├── cache_utils.py           # private atomic helper caches (0700/0600)
│   │   ├── claude-mem-save.py       # shell-safe optional claude-mem HTTP adapter
│   │   ├── session-scan.py          # JSONL parser (Claude + Codex) with incremental cache
│   │   ├── skills-discover.py       # Auto-discovery across Claude/Codex skill paths
│   │   ├── review-candidates.py     # type-aware staleness scan for /mn:health
│   │   └── check-cm-version.sh      # claude-mem cache inspector
│   └── hooks/                       # Harness hooks
│       ├── hooks.json               # Codex-safe shared SessionStart + Stop baseline
│       ├── claude-hooks.json        # manifest-listed Claude-only UserPromptExpansion echo
│       ├── prewarm.sh               # Codex-compatible SessionStart cache warmup
│       ├── mnemo-context.sh         # SessionStart nudge — memory exists (config-gated)
│       ├── mnemo-skill-echo.sh      # /mn:* expansion echo — visible skill-load confirmation
│       └── mnemo-stop-nudge.sh      # Stop nudge — save before wrapping up (opt-in)
├── .claude-plugin/marketplace.json  # Claude Code marketplace entry
├── .agents/plugins/marketplace.json # Codex marketplace entry
├── .github/workflows/skill-lint.yml # CI: validates SKILL.md frontmatter + refs
├── .github/workflows/release.yml    # CI: mirror CHANGELOG section → GitHub Release on tag
├── scripts/lint-skills.py           # Dual-runtime structural linter
├── scripts/test-runtime-compat.py   # Claude/Codex regression tests
├── scripts/test-runtime-memory.py   # cross-runtime scope/security/bounds tests
├── scripts/test-handoff-archive.py  # Handoff archive regression tests
├── docs/codex.md                    # Codex install, invocation, runtime differences
├── AGENTS.md · CONTRIBUTING.md · CHANGELOG.md · TESTING.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.
Andrej Karpathy's "LLM Wiki" (2026) — the operational model mnemo implements: an AI reads sources once, builds & maintains an interlinked markdown wiki, then "lints" it. /mn:health is that lint.

Contributing

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

Русский

Что делает

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

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

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

Вызов: в Claude Code используются точные команды /mn:save. В Codex тот же mn:save показывается как UI-имя скилла, а гарантированный явный вызов — $mnemo:save (набери $ или открой /skills). Примеры ниже используют синтаксис Claude, если не указано иное.

Скиллы

Скилл	Команда	Что делает
save	`/mn:save`	Каскад роутинга — сохраняет в Obsidian (+ опциональный claude-mem и включённую auto-memory Claude); generated memory Codex остаётся read-only
session	`/mn:session`	Сессионная заметка + cross-session handoff для следующей сессии
review	`/mn:review`	Оркестратор конца сессии — аудит, единый список рекомендаций и подтверждение перед любым запуском
ask	`/mn:ask`	Поиск по vault + памяти активного runtime (+ опционально проверенная память второго runtime), синтез с цитатами и сверка актуальности по git
connect	`/mn:connect`	Находит скрытые связи между заметками — предлагает, не применяет сам
health	`/mn:health`	Аудит vault: orphans, битые ссылки, type-aware кандидаты на ревью (+ опц. LLM-линт), статистика роста
setup	`/mn:setup`	Интерактивный онбординг — vault, таксономия, язык, опциональный cross-runtime recall

Когда что использовать

Момент	Команда
Как только появился факт/решение/находка, по ходу сессии	`/mn:save` — фиксируй сразу, не копи (компакт может срезать контекст в любой момент)
Вспомнить контекст / прошлые решения	`/mn:ask`
Только что создал заметки — найти скрытые связи	`/mn:connect`
Конец работы, или перед длинным прогоном, рискующим компактом	`/mn:session` — журнал сессии + handoff
Одна команда на закрытие сессии	`/mn:review` — аудит + рекомендации save & session + одно подтверждение
Периодически / после 3+ новых заметок	`/mn:health`

save и session дополняют друг друга, это не «или-или»: save фиксирует дискретные факты по ходу; session пишет нарратив + handoff в конце. review предлагает оба, но ничего не запускает без подтверждения, поэтому защищённая от потерь привычка = save по ходу плюс явный session/review в конце.

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

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

Ключевые возможности

Cross-runtime recall без синхронизации (v1.2.3) — opt-in recall.runtimeMemory даёт Codex видеть проверенную проектную память Claude, а Claude — project-scoped память Codex. Это ограниченный read-only слой с точным доказательством git-репозитория: без transcript scan, symlink, общего writer, зеркала, демона и второй копии. Obsidian остаётся главным источником, runtime-memory цитируется как недоверенное вторичное свидетельство.
Одна каноническая поверхность в Claude Code и Codex (v1.2.0; парсинг Codex hooks усилен в v1.2.1; автодискавери стандартного Claude hook-файла исправлен в v1.2.4) — те же семь реализаций напрямую регистрируются как /mn:* в Claude Code и как $mnemo:* с совпадающими UI-именами mn:* в Codex. Старые command-router’ы и alias-копии удалены; hooks компонуются по runtime, а portable discovery, приватные кеши и argv-safe доступ к Obsidian держат обе среды синхронными без дублирования логики.
Знание накапливается + самоснузящийся линт + research-гэпы (v0.14.0) — три opt-in, на-философии вывода из полного аудита паттерна Карпати «LLM Wiki». /mn:ask может свернуть настоящий синтез обратно в vault в тип, заданный taxonomy_roles.insight (в дефолте Molecule; источники уже слинкованы), чтобы исследования накапливались; review.lint.autoStampReviewed позволяет линту штамповать reviewed: на still-valid заметках, замыкая петлю снуза; /mn:health показывает research-gap кандидатов (популярный топик без MOC, частый внешний источник без Source-заметки). Всё opt-in: дефолтная установка ничего не пишет (контент-линт выключен), сохранение синтеза — по подтверждению, а единственная авто-запись (штамп reviewed:) срабатывает только когда ты включишь линт.
Recall, заземлённый в живом коде (v0.13.0) — на вопросы «актуально ли / что изменилось» внутри git-проекта /mn:ask сверяется со свежими коммитами репо и флажит заметки, которые новый коммит мог устаревшить. Опц. code-graph бэкенд через recall.codeGraph (Graphify / Sourcegraph / ast-grep…), выключен по умолчанию.
Recall со свежестью (v0.12.0) — /mn:ask теперь датирует каждый цитируемый источник (git last-commit если vault под git, иначе mtime файла + frontmatter reviewed/date) и помечает ответ, опирающийся на устаревшие заметки.
Type-aware ревью + контент-линт (v0.11.0) — /mn:health помечает устаревшие заметки по бюджету на тип (review.staleDays), а не единым «30 дней»; снуз reviewed: + per-note ttl:; опц. LLM-линт (review.lint.enabled) перечитывает кандидатов на устаревшие/противоречащие утверждения — «lint your wiki» Карпати. Changelog переехал в Keep a Changelog v2 + GitHub Releases.
Autodream-aware индекс памяти (v0.10.0–0.10.1; effective-path hardening в v1.2.5) — /mn:health проверяет реально выбранную auto-memory Claude с учётом runtime config и лимитов загрузчика. /mn:ask может цитировать verified runtime-generated memory, но mnemo никогда вручную не редактирует ${CODEX_HOME:-~/.codex}/memories/.
PKM-канон + меньше скиллов (v0.9.0) — убран inbox-triage (8 → 7 скиллов): в agent-driven потоке типизированные заметки пишутся напрямую, триажить нечего. Вшиты правила именования (# . / .md запрещены), hub-заметки для коротких имён, metadataCache-вместо-CLI-кеша для точной проверки ссылок.
Dual-runtime (v0.8.0–0.8.2) — переименование claude-mnemo → mnemo; нативная поддержка Codex рядом с Claude Code из одного набора скиллов.

Полная история по версиям: CHANGELOG.md.

Установка

Claude Code

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

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

Старый путь jojoprison/claude-mnemo остаётся совместимым через GitHub redirect, но новые установки должны использовать jojoprison/mnemo.

Codex

codex plugin marketplace add jojoprison/mnemo
codex plugin add mnemo@mnemo

В Codex набери $ или открой /skills, выбери короткое имя mn:*, либо вызови стабильный ID напрямую: $mnemo:ask, $mnemo:save, $mnemo:session, $mnemo:review, $mnemo:connect, $mnemo:setup, $mnemo:health. Auto-invocation по description тоже работает. Literal-команды /mn:* относятся к Claude Code.

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

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

Примеры

Сохранение решений и находок (в любой момент, по ходу)

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

Роутит в Obsidian, опциональный claude-mem и включённую auto-memory Claude, когда уместно. ${CODEX_HOME:-~/.codex}/memories/ — generated read-only state Codex, не fallback для ручной записи. Недоступные backend’ы показываются явно.

Физические типы заметок определяются только через пять точных ролей fact/insight/source/session/moc: каждая цель существует в taxonomy, session → session и moc → moc обязательны, а три контентные роли могут делить один тип.

Оркестратор конца сессии (единственная команда на закрытие)

/mn:review

Анализирует сессию и показывает один приоритетный список: несохранённые решения, session notes и остальные действия. Ничего не запускает без твоего выбора.

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

/mn:session

Создаёт заметку в Obsidian и обновляет handoff для следующей сессии. Больше никакого «а что я вчера делал?»

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

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

Синтезирует ответ с цитатами по vault и памяти активного runtime. При recall.runtimeMemory.enabled: true добавляет bounded read-only память второго runtime для того же git-репозитория — ничего не копирует и не синхронизирует.

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

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

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

Аудит vault

/mn:health

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

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

🔴 Orphans: 3
🏆 Топ-5 хабов: MOC — Security (34), MOC — AI ML Tools (28)...

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

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

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

Все поля опциональны. Скиллы спросят при первом запуске. Cross-runtime recall выключен по умолчанию; включение: recall.runtimeMemory.enabled: true. Полная схема и security-границы — в plugins/mnemo/references/config-schema.md.

Непрерывность между сессиями

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

Требования

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

中文

功能介绍

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

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

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

调用方式： Claude Code 使用 /mn:save 这样的精确命令。Codex 的技能选择器显示同样的 mn:save 标签，而稳定的显式调用是 $mnemo:save（输入 $ 或打开 /skills）。除非另有说明，下方示例使用 Claude 语法。

技能列表

技能	命令	功能
save	`/mn:save`	路由级联 —— 保存到 Obsidian（+ 可选 claude-mem 与已启用的 Claude auto-memory）；Codex 生成的记忆保持只读
session	`/mn:session`	会话摘要笔记 + 跨会话上下文传递
review	`/mn:review`	会话结束编排器 —— 审计会话、统一推荐，并在运行任何技能前请求确认
ask	`/mn:ask`	搜索 vault + 当前运行时记忆（+ 可选且已验证的另一运行时记忆），综合引用并用 git 核验当前状态
connect	`/mn:connect`	发现笔记之间隐藏的联系 —— 仅建议，不自动应用
health	`/mn:health`	Vault 审计：孤立笔记、断链、按类型的复查候选（+ 可选 LLM lint）、增长统计
setup	`/mn:setup`	交互式引导配置 —— vault、分类法、语言、可选跨运行时回忆

何时用哪个

时机	命令
一出现事实/决策/发现，会话进行中	`/mn:save` —— 随时保存，不要囤积（压缩随时可能丢上下文）
回忆早先上下文 / 过往决策	`/mn:ask`
刚创建笔记 —— 发现隐藏联系	`/mn:connect`
工作结束，或长会话有压缩风险之前	`/mn:session` —— 写入旅程笔记 + 交接
结束会话的单一命令	`/mn:review` —— 审计 + 推荐 save 与 session + 一次确认
定期 / 创建 3+ 新笔记后	`/mn:health`

save 和 session 互补，而非二选一：save 随时固定离散事实；session 在结束时写入叙事 + 交接。review 会推荐两者，但未经确认绝不运行；最稳妥的习惯仍是全程 save 加上结束时显式 session/review。

为什么不用 Obsidian 插件？

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

功能亮点

跨运行时回忆，无需同步（v1.2.3）—— 可选的 recall.runtimeMemory 让 Codex 读取已验证的 Claude 项目记忆，也让 Claude 读取项目范围内的 Codex 记忆。这是有界只读层：严格匹配同一 git 仓库，不扫描 transcript，不用 symlink、共享写入器、镜像、daemon 或重复存储。Obsidian 仍是权威来源；运行时记忆仅作为带出处的不可信次级证据。
Claude Code 与 Codex 共用唯一规范入口（v1.2.0；v1.2.1 加强 Codex hook 解析兼容性；v1.2.4 修正 Claude 默认 hook 自动发现）—— 同一套七个实现现在在 Claude Code 中直接注册为 /mn:*，在 Codex 中注册为 $mnemo:*，并显示对应的 mn:* 选择器标签。旧 command router 与 alias 技能副本已移除；按运行时组合的 hooks、可移植运行时发现、私有缓存和 argv-safe Obsidian 访问让两个运行时保持一致且不重复逻辑。
知识复利 + 自我延后的 lint + 研究缺口（v0.14.0）—— 对 Karpathy "LLM Wiki" 模式做完整审计后提炼出的三个可选、契合理念的增强。/mn:ask 可将真正的综合写回 taxonomy_roles.insight 指定的类型（默认为 Molecule；来源已预先链接），让探索得以累积；review.lint.autoStampReviewed 让 lint 给仍然有效的笔记盖上 reviewed:，闭合延后回路；/mn:health 会提示研究缺口候选（笔记众多却无 MOC 的主题、被频繁引用却无 Source 笔记的外部实体）。全部可选：默认安装不写入任何内容（内容 lint 默认关闭），综合写回需用户确认，唯一的自动写入（reviewed: 标记）仅在你开启 lint 后才发生。
基于实时代码的回忆（v0.13.0）—— 在 git 项目内回答"是否仍然成立/有何变化"类问题时，/mn:ask 会对照仓库最近的提交，标记可能已被新提交过时的笔记。可选代码知识图谱后端 recall.codeGraph（Graphify / Sourcegraph / ast-grep…），默认关闭。
带时效的回忆（v0.12.0）—— /mn:ask 现在为每个引用来源标注更新时间（vault 是 git 仓库则用 git last-commit，否则用文件 mtime + reviewed/date frontmatter），并标记基于陈旧笔记的答案。
按类型的复查 + 内容 lint（v0.11.0）—— /mn:health 按类型预算（review.staleDays）标记陈旧笔记，而非统一的 30 天；reviewed: 缓刑 + 单笔记 ttl:；可选 LLM lint（review.lint.enabled）重读候选以发现过时/矛盾的声明 —— Karpathy 的 "lint your wiki"。Changelog 迁移到 Keep a Changelog v2 + GitHub Releases。
Autodream 感知的记忆索引（v0.10.0–0.10.1；v1.2.5 加固 effective-path）—— /mn:health 按 Claude 当前实际 auto-memory 路径和加载限制检查索引。/mn:ask 可以引用已验证的运行时生成记忆，但 mnemo 从不手动修改 ${CODEX_HOME:-~/.codex}/memories/。
PKM 规范 + 更精简的技能集（v0.9.0）—— 移除 inbox-triage（8 → 7 个技能）：在代理驱动的流程中，类型化笔记被直接写入，没有需要分类的收件箱。内置笔记命名规则（禁用 # . / .md）、短名称的 hub 笔记、用 metadataCache 而非 CLI 缓存进行准确的链接检查。
双运行时（v0.8.0–0.8.2）—— 更名 claude-mnemo → mnemo；从同一套共享技能原生支持 Codex 与 Claude Code。

完整逐版本历史：CHANGELOG.md。

安装

Claude Code

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

# 安装插件
claude plugin install mnemo@mnemo

旧路径 jojoprison/claude-mnemo 仍可通过 GitHub redirect 工作；新安装请使用 jojoprison/mnemo。

Codex

codex plugin marketplace add jojoprison/mnemo
codex plugin add mnemo@mnemo

在 Codex 中输入 $ 或打开 /skills，选择短标签 mn:*；也可以直接使用稳定 ID：$mnemo:ask、$mnemo:save、$mnemo:session、$mnemo:review、$mnemo:connect、$mnemo:setup、$mnemo:health。基于 description 的自动调用同样可用。Literal /mn:* 命令属于 Claude Code。

首次运行

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

使用示例

保存决策与发现（随时，边做边存）

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

路由到 Obsidian、可选 claude-mem，以及适用且已启用的 Claude auto-memory。${CODEX_HOME:-~/.codex}/memories/ 是 Codex 生成的只读状态，不作为手动写入 fallback；不可用的后端会明确报告。

物理笔记类型只通过五个精确语义角色 fact/insight/source/session/moc 解析：所有目标必须存在于 taxonomy，session → session 与 moc → moc 必须自映射，三个内容角色可以有意共享同一类型。

会话结束编排器（结束会话只需这一个）

/mn:review

分析会话并显示一个按优先级排序的列表：未保存的决策、会话笔记以及其余操作。未经你的选择，不会运行任何项目。

会话笔记 + 交接

/mn:session

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

知识搜索

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

从 vault 与当前运行时记忆中综合带引用的答案。启用 recall.runtimeMemory.enabled: true 后，还会加入同一 git 仓库的另一运行时记忆作为有界只读证据；不会复制或同步任何内容。

发现隐藏联系

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

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

Vault 审计

/mn:health

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

总计：487 个笔记
  Atoms: 89 | Molecules: 23 | Sources: 34
  Sessions: 67 | MOCs: 14

🔴 孤立笔记：3
🏆 前5大枢纽：MOC — Security (34), MOC — AI ML Tools (28)...

配置

/mn:setup 或手动：

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

所有字段可选。技能会在首次使用时询问。跨运行时回忆默认关闭；通过 recall.runtimeMemory.enabled: true 启用。完整 schema 与安全边界见 plugins/mnemo/references/config-schema.md。

跨会话连续性

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

环境要求

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

Made with care by Claude Code + jojoprison

Name		Name	Last commit message	Last commit date
Latest commit History 104 Commits
.agents/plugins		.agents/plugins
.claude-plugin		.claude-plugin
.codex/environments		.codex/environments
.github/workflows		.github/workflows
docs		docs
evals		evals
plugins/mnemo		plugins/mnemo
scripts		scripts
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
TESTING.md		TESTING.md
config.example.json		config.example.json
social-preview.png		social-preview.png

Folders and files

Latest commit

History

Repository files navigation

mnemo

What It Does

The Skills

When to Use Which

Why Not Just Use Obsidian Plugins?

Highlights

Architecture

Quick Start

Install: Claude Code

Install: Codex

First Run

Usage Examples

Save decisions and findings (any time, as they happen)

End-of-session orchestrator (the one command to close a session)

Session notes + handoff

Search your knowledge base

Discover hidden links

Weekly vault checkup

Configuration

Custom Taxonomy

Cross-Session Continuity

Requirements

Project Structure

Inspired By

Contributing

Русский

Что делает

Скиллы

Когда что использовать

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

Ключевые возможности

Установка

Claude Code

Codex

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

Примеры

Сохранение решений и находок (в любой момент, по ходу)

Оркестратор конца сессии (единственная команда на закрытие)

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

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

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

Аудит vault

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

Непрерывность между сессиями

Требования

中文

功能介绍

技能列表

何时用哪个

为什么不用 Obsidian 插件？

功能亮点

安装

Claude Code

Codex

首次运行

使用示例

保存决策与发现（随时，边做边存）

会话结束编排器（结束会话只需这一个）

会话笔记 + 交接

知识搜索

发现隐藏联系

Vault 审计

配置

跨会话连续性

环境要求

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 45

Packages 0

Packages