OKF Agent Memory

Generic Open Knowledge Format (OKF) project memory templates and agent skills for Claude Code and Codex.

The plugin gives coding agents a small, durable memory workflow:

• initialize okf-memory/ in a project when missing;
• read base knowledge and today's daily log at start of work;
• roll prior daily logs into base knowledge on date change;
• record only new durable facts at end of work.

It stores memory as plain markdown with YAML frontmatter, following the OKF idea of portable agent-readable knowledge.

References:

• Google Cloud OKF announcement
• Open Knowledge Format spec

Install

Claude Code

claude plugin marketplace add tsnAnh/okf-agent-memory
claude plugin install okf-agent-memory@okf-agent-memory

Use the skill as /okf-agent-memory:manage-okf-memory.

Codex

codex plugin marketplace add tsnAnh/okf-agent-memory --ref main
codex plugin add okf-agent-memory@okf-agent-memory

The manage-okf-memory skill is available after starting a new Codex thread.

Template Layout

okf-memory/
  index.md
  log.md
  base/
    coding-patterns.md
    human-style.md
    project-requirements.md
    decision-changes.md
    major-changes.md
    roadmap.md
  daily/
    YYYY-MM-DD.md

templates/okf-memory/ contains the generic starter bundle. The plugin also bundles the same files under plugins/okf-agent-memory/assets/okf-memory-template/.

Rules

Record only new durable facts:

• coding patterns agents should repeat;
• human communication or report preferences;
• stable project requirements and verification rules;
• accepted, rejected, or superseded decisions;
• major repository changes;
• roadmap changes.

Skip repeated facts, speculative ideas, temporary build logs, local private values, secrets, tokens, credentials, and environment values.

License

MIT