By fx818
Portable cross-session memory for any repo. An Open Knowledge Format (OKF) bundle of markdown concept files lives in-repo at .knowledge/, so a fresh session knows the codebase vocabulary and architecture without re-reading source.
Portable cross-session memory for any repo, in the Open Knowledge Format (OKF).
A bundle of markdown concept files lives in-repo at .knowledge/, so a fresh Claude Code session knows the codebase's vocabulary and architecture without re-reading source files or making you re-explain terms every session.
Start a new session and the agent knows nothing. It re-reads source to relearn the codebase (expensive in tokens) and you re-explain project terms again. Worse, ad-hoc memory tends to be stored as an event log ("renamed X to Y") that only accumulates and eventually contradicts itself, while the freshest truth sits in a file that never auto-loads.
.knowledge/index.md is a cheap progressive-disclosure map. It's the only file loaded at session start. The map alone usually answers "what do the terms mean / what's the shape"..knowledge/<concept>.md files hold current truth, one subsystem or topic each, present tense. Opened only when a task touches that area..knowledge/log.md is append-only history - what changed, when. Not auto-loaded.timestamp, so freshness is per fact - re-verify only what's stale, not the whole bundle.State (overwritten) is kept strictly apart from history (appended). That separation is what stops the rot.
| Piece | Role |
|---|---|
skills/okf-memory | Loads on mutation (not every session): drill into a concept, overwrite + restamp after changes, re-verify stale. Read-only sessions use the SessionStart hook alone. |
/okf-init | Create the bundle for a repo that has none. Shallow 3-layer structure scan only - never reads the whole codebase. |
/okf-sync | Fold recent changes into concepts and restamp. |
/okf-check | Audit for staleness, contradictions, coverage gaps. |
| SessionStart hook | Injects .knowledge/index.md if present, else hints to run /okf-init. |
| PostToolUse hook | Non-blocking, throttled nudge after source edits; records each changed file path in .okf-dirty. |
| Stop hook | If source changed this session, auto-runs a surgical /okf-sync (only the changed files' concepts) before the turn ends. Throttled to once per 10 min; changes accumulate between syncs. |
/plugin marketplace add fx818/okf-memory
/plugin install okf-memory
Then in any repo:
/okf-init # build the bundle (writes immediately, no approval prompt)
Commit .knowledge/ so the memory travels with the repo. Add .knowledge/.okf-last-nudge, .knowledge/.okf-dirty, and .knowledge/.okf-last-sync to .gitignore (internal hook stamps).
It's just markdown + YAML - no runtime, no SDK, no database. Full spec in skills/okf-memory/references/format.md. Inspired by Google Cloud's Open Knowledge Format.
Modifies files
Hook triggers on file write and edit operations
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub fx818/okf-memory --plugin okf-memoryMulti-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Memory compression system for Claude Code - persist context across sessions
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Comprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Write feature specs, plan roadmaps, and synthesize user research faster. Keep stakeholders updated and stay ahead of the competitive landscape.