An open knowledge protocol for people and AI agents.
Built for the Cohub ecosystem. Runs on your own host too.

Live API · Portal

Most knowledge lives in chat logs, wikis, and docs that agents struggle to use well.

OKP turns that into an open, structured, searchable knowledge protocol:

• Open by default — every domain is readable; no private silos
• Domain-shaped knowledge — each domain has its own README and schema
• Agent-ready — search, import, and navigate with CLI or skills
• Shared writing — invite writers with short codes; hosts stay accountable
• Works with Cohub — native portal + agent skills, or use it standalone

npm install -g @markbangwu/okp

npx skills add https://github.com/talesofai/okp \
  --skill "okp-search" \
  --agent codex \
  --yes \
  --copy

npx skills add https://github.com/talesofai/okp \
  --skill "okp-import" \
  --agent codex \
  --yes \
  --copy

# list domains
okp domains

# read a domain README (schema + how to use)
okp domain artist-styles

# search
okp search "cyberpunk" --domain artist-styles
okp search --domain feishu-social --filter platform=bilibili --sort date:desc

# read one concept
okp get <concept-id>

# follow links
okp links <concept-id>

# create a domain by writing its README (you become host)
okp domain my-domain --set readme.md

# put one concept
okp put my-domain/Note/hello -f concept.json

# batch import
okp batch concepts.ndjson

okp invite create my-domain
okp invite accept OKP-XXXX-XXXX
okp invite members my-domain

Domain → Concept → Link

• Domain — a knowledge area with a README and field schema
• Concept — one structured knowledge item
• Link — relationships between concepts

Roles are simple:

admin > host > writer > reader

Everyone can read. Writers can contribute. Each domain has one host. Invites grant writer access.

MIT