codex-okf

OpenAI Codex plugin for Open Knowledge Format (OKF) v0.1.

Full parity with opencode-okf / claude-okf / pi-okf:

Feature	Mechanism
Init / update / compact workflows	Bundled skill (skills/okf)
okf_validate, okf_capture, okf_diff	MCP server (.mcp.json)
Validate-on-edit	PostToolUse hooks on apply_patch/Edit/Write
Session hint when bundle exists	SessionStart hook
CLI	scripts/okf.mjs

Install (local marketplace)

cd /Users/kaishin/Developer/Spikes/codex-okf
npm install

# Personal marketplace entry
mkdir -p ~/.agents/plugins ~/.codex/plugins
ln -sfn /Users/kaishin/Developer/Spikes/codex-okf ~/.codex/plugins/okf

Create or merge ~/.agents/plugins/marketplace.json:

{
  "name": "local-kaishin",
  "interface": { "displayName": "Local (Kaishin)" },
  "plugins": [
    {
      "name": "okf",
      "source": { "source": "local", "path": "./.codex/plugins/okf" },
      "policy": {
        "installation": "AVAILABLE",
        "authentication": "ON_INSTALL"
      },
      "category": "Developer Tools"
    }
  ]
}

Then in Codex / ChatGPT desktop: Plugins → your local marketplace → install OKF.

Trust plugin hooks when prompted (/hooks in CLI) so validate-on-edit runs.

Remove any old skill-only symlink if present:

rm -f ~/.agents/skills/okf

Usage

• $okf or ask about OKF / knowledge bundles
• MCP tools: okf_validate, okf_capture, okf_diff
• CLI:

node scripts/okf.mjs validate
node scripts/okf.mjs diff origin/main
node scripts/okf.mjs capture --summary "…" --decision "…"
node scripts/okf.mjs init

Workflow hard args (same as siblings):

update                 # full repo
update diff [ref]
update session
compact
compact all [aggressive]

Layout

.codex-plugin/plugin.json
.mcp.json
hooks/{hooks.json,post-edit-validate.mjs,session-start.mjs}
skills/okf/
scripts/{okf.mjs,mcp-server.mjs,lib/*}

License

MIT