hypo

English | 한국어

Hypomnema

LLM-native personal wiki for Claude Code. Knowledge that compounds.

Make Claude take notes, and measure whether it actually does.

Quick Start • How It Compares • Design Decisions • Features • Architecture • Contributing

Inspired by Andrej Karpathy's "LLM-native wiki" sketch, shaped by ten months of personal AI-workflow experiments and a month of dogfooding before the public release. Hypomnema ships the full lifecycle, from capturing a source to synthesizing, retrieving, and resuming a paused session, as Claude Code commands and lifecycle hooks.

New to the terms below? Keep the Term decoder open in another tab. It defines frontmatter, wikilink, projection, hook, hot.md, and session-state.md, one line each.

Where automation stands today

The current release is v1.5.0. It turns to cross-machine reliability and everyday friction. On a git-synced vault shared across machines, cwd-first resume finds the right project; a session working in a code repo is told where the wiki lives instead of re-discovering it each time; and session close no longer re-lists unrelated lint debt or dumps hundreds of warnings into context. The v1.4.x line hardened the session-close path before it.

Wiki work (ingest, query, session-close) still starts from an explicit /hypo:* command or plain language. The v2 goal is full autonomy: Claude reading, writing, and synthesizing the wiki without being asked, which is the direction this is heading.

The lanes that already run on their own: v1.1.0 shipped the observability score that measures how often the wiki is used per session, and v1.2.0 added four automated areas on top.

• Edit feedback in one place and the rest follows. pages/feedback/ is the single source of truth for behavior corrections, and Hypomnema derives MEMORY.md and the <learned_behaviors> block inside ~/.claude/CLAUDE.md from it automatically.
• Extensions sync alongside. Anything under ~/hypomnema/extensions/{agents,commands,hooks,skills}/ is mirrored into ~/.claude/ automatically. The --codex flag also mirrors hooks and commands into ~/.codex/; agents and skills are Claude-only and skipped on purpose.
• Auto-project creation. When you cd into a git repo with a project marker (package.json, Cargo.toml, etc.) and no matching wiki project exists, Hypomnema offers to scaffold one.
• Session-close cleanup and /clear recovery. After a non-trivial session, a "save a minimal session-close note?" prompt appears automatically; a /clear after a forgotten close is detected and recovered at the next session start.

What changed per version lives in the CHANGELOG.

One upgrade policy worth knowing up front: hypomnema upgrade --apply never overwrites a SCHEMA.md you have edited. When the schema bumps, upgrade writes a migration report into the wiki root and leaves the actual changes for you to apply (the policy the code calls Option C).

---

Quick Start

There are two install paths. Either one ends up with the same wiki, hooks, and /hypo:* slash commands.

Path A: Claude Code plugin (recommended)

Inside Claude Code:

/plugin marketplace add sk-lim19f/Hypomnema
/plugin install hypo@hypomnema
/hypo:init

The plugin install registers /hypo:* commands from the package's commands/ directory; /hypo:init then scaffolds the wiki and merges hooks into ~/.claude/settings.json.

Path B: npm CLI

In your shell:

npm install -g hypomnema
hypomnema

hypomnema (or hypomnema --help for flags) scaffolds the wiki and installs hooks. It also copies the slash command files to ~/.claude/commands/hypo/, so /hypo:* works inside Claude Code afterwards. Later hypomnema upgrade runs use per-file SHA tracking, so anything you hand-edited stays put.

Either path: restart Claude Code (or open a new session) after the first run so the new hooks and slash commands are picked up.

Step 2: use it