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:

• Public by default — domains are open unless their creator chooses private visibility
• 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

# create a private domain
okp domain my-private-domain --set readme.md --visibility private

# 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 create my-private-domain --role reader
okp invite accept OKP-XXXX-XXXX
okp invite members my-domain

okp delete my-domain/Note/hello --yes
okp domain my-domain --delete --yes

Domain → Concept → Link

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

Access depends on domain visibility:

public:  admin/host > writer > reader
private: host > writer > reader

Public domains are readable by every authenticated user. Private domains are only discoverable and readable by explicitly invited members, including global admins. Writers can contribute concepts. Each domain has one host, and only the host manages a private domain.

MIT