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.1. It sharpens how the wiki signals its own freshness: a page whose verify_by_date has passed is flagged [STALE ...] at the moment it is injected, so a dated answer is visible instead of trusted silently, and lookup usage is tracked locally so crystallize can surface a linked-but-never-injected page as a cold candidate. The same release makes session close robust to the standard session | project: title colon log format that had been misread as stale. The v1.5.0 line turned to cross-machine reliability and everyday friction before it: cwd-first resume on a git-synced vault, a code-repo session told where the wiki lives, and session close no longer re-listing unrelated lint debt.

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