Google's Open Knowledge Format (OKF) is a directory of Markdown files with YAML frontmatter that humans and AI agents co-author. FlashType is built for exactly that: render the frontmatter and body live, let Claude Code or Codex edit your bundle, and review every change as a diff before it lands. Free and open source.
The Open Knowledge Format (OKF) is an open spec that represents knowledge - metadata, context, and curated insight for AI systems - as a directory of Markdown files with YAML frontmatter. It's the smallest possible agreement on shape: enough convention for agents to interoperate, and nothing else.
An OKF bundle is a directory of .md files, each with a small YAML frontmatter block (a required `type`, plus optional title, description, resource, tags, timestamp). No SDK, no runtime, no database - if you can read a Markdown file, you can read OKF.
Each file is one concept; the file path is its identity. Concepts reference each other with normal Markdown links, turning the directory into a knowledge graph. Optional index.md files give agents progressive disclosure; log.md tracks change history.
OKF formalizes the “LLM-wiki” pattern (Karpathy's gist, AGENTS.md / CLAUDE.md, Obsidian-vault-as-context) into one portable spec. A human-authored bundle, a pipeline export, and an agent-synthesized bundle are all the same readable files.
OKF v0.1 was published by Google Cloud in June 2026 as a vendor-neutral, Apache-2.0 spec - intentionally not a product. The whole specification fits on a single page, and bundles live in Git alongside the code they describe, reviewed with pull requests and diffs like any other source.
An OKF bundle is meant to be curated like code - written and updated by agents, reviewed by people. FlashType puts the agent inside the editor, on your real bundle files, so enriching a knowledge base feels like reviewing a pull request, not babysitting a chat window.
Point FlashType at the bundle directory - your concept .md files, index.md, and log.md. It's a folder of local files, so there's no import step and nothing leaves your machine.
Ask Claude Code or Codex to draft a concept, fill in a schema, add cross-links, or reconcile frontmatter across the bundle. The agent edits the real files - exactly the bookkeeping LLMs are good at and humans abandon.
Each edit lands as an inline diff. Accept the accurate concepts, reject the rest - and every change is tracked in version history, so your knowledge bundle never drifts behind your back.
OKF is just files, so anything can open it - but authoring a whole bundle means writing frontmatter, wiring cross-links, and keeping concepts accurate as agents touch them. FlashType is built for that loop: live rendering, agents on your files, and every change reviewed before it lands.
| Capability | FlashType | Plain text editor | Obsidian / Notion |
|---|---|---|---|
| Edits OKF .md files directly on disk | Some | ||
| Renders YAML frontmatter + Markdown body live | — | Some | |
| Claude Code & Codex built into the editor | — | — | |
| Agents author & enrich the bundle | — | — | |
| Review each agent edit as an inline diff | — | — | |
| Accept or reject changes one by one | — | — | |
| Automatic version history (via Lix) | — | Some | |
| Git / repo-friendly, no proprietary store | — | ||
| Free & open source | Some | — |
OKF is an open specification from Google Cloud (v0.1, June 2026) for representing the knowledge AI agents need. A bundle is just a directory of Markdown files with YAML frontmatter - no SDK, runtime, or registry. It formalizes the “LLM-wiki” pattern into one portable, vendor-neutral format so wikis written by one producer can be read by any agent.
Plain Markdown (.md) files with a small YAML frontmatter block. Each concept is one file, and the only required field is `type`; title, description, resource, tags, and timestamp are optional. Concepts link to each other with normal Markdown links, and reserved index.md / log.md files handle directory listings and change history.
Because OKF is Markdown + YAML edited by both people and agents, the right editor renders frontmatter and body live and keeps AI under review. FlashType runs Claude Code and Codex directly on your bundle's local files and shows every agent edit as an inline diff, so you approve or reject each change instead of pasting in unreviewed output.
Yes - that's the point of the format. OKF was designed so enrichment agents can write into it and consumption agents can read it without translation. In FlashType, you direct Claude Code or Codex to draft concepts, add schemas, and fix cross-links across the bundle, then review the diffs before anything is saved.
Version history powered by Lix tracks every change automatically - what the agent changed, when, and why - so you can roll back any edit. Combined with diff-by-diff review, your bundle stays curated like code instead of accumulating silent, unreviewed rewrites.
Yes. FlashType is free, open source under the MIT license, and runs on macOS. It edits plain .md files in any folder or Git repo, so it works on OKF bundles with no migration or proprietary format. Issues, pull requests, and stars are welcome on GitHub.
Built in the open. Issues, pull requests and stars welcome.