Latest release Built on Google's Open Knowledge Format v0.1.

Knowledge that works with your agents.

Create, retrieve, maintain, validate, and publish flexible knowledge bases in Markdown with the agents you already use.

Works with
  • Codex
  • Claude
  • Cursor

Context you can keep

Setup

Create with your agent

Copy the setup prompt into an agent already working in the folder, or let okn setup --agent --runtime <runtime> launch one.

Local machine context

Keep context local

Work with knowledge as local Markdown and YAML files on your machine.

Retrieval

Retrieve only what matters

search ranks relevant sections and builds source-preserving context within the token budget you set.

Publishing

Publish without lock-in

Ship searchable static HTML or export JSON, graph data, and a portable tar archive from the same authored bundle.

Checks

Trust it before use

Validate OKF structure and report local-link warnings before people or agents rely on the wiki; promote warnings to errors when policy requires it.

OKF

Own the source

Built on Google's Open Knowledge Format v0.1: Markdown plus YAML frontmatter that stays inspectable, diffable, and easy to maintain.

One CLI, end to end.

Layer Commands Outcome
Start here setup, search, validate Print a knowledge-base setup prompt, retrieve useful context, and verify its source.
Work locally agent, integration, get, list, view Maintain, connect, read, and browse knowledge on this machine.
Share and connect export, mcp, connect, disconnect, registry Publish portable views and resolve local or remote bundles.
Automate and operate automation Run jobs, insights, hosted runtimes, and deployments.
Advanced and portable tools scaffold, prompt, ast, spec, version Use deterministic primitives or print instructions for another agent host.

From Markdown to shared context

Create a knowledge base

Run the open-ended setup interview with your current agent, or let the CLI launch a selected runtime.

okn setup
okn setup --agent --runtime codex

Build from another source

Print a prompt grounded in a repository, folder, or website, then give it to your agent.

okn setup Wiki --from https://github.com/openknowledge-sh/openknowledge
okn setup Wiki --from https://openknowledge.sh/wiki/ --depth 2

Connect and retrieve

Give the bundle a stable name, then search it or browse it locally.

okn connect Wiki --as project
okn search project "validation workflow"
okn view project

Validate before use

Catch structure errors and review link warnings before agents or publishing depend on the wiki.

okn validate Wiki
okn list --depth 2 Wiki
okn ast Wiki

Publish or integrate

After reviewing public content and setting [publish] enabled = true, ship a static site or export portable machine-readable views.

okn export html --out ./project-site Wiki
okn export json Wiki
okn export tar --out ./project-wiki.tar.gz Wiki