Typed · git-backed · human-reviewed

The trusted
knowledge layer
for a world
run by agents.

Knowledge scattered across mail, meetings and systems drifts — unseen, unstructured, unchecked. And agents are reading and writing it now. Kyyn gives agents and humans one validated ground truth to build together: the agent proposes; you accept.

cargo install kyyn
proposal:2026-07-08-a DRAFT
JR
Jordan Reyes
person:jordan-reyes
UPDATED
Agent summary · from 2 emails, 1 chat
Went permanent at Northwind Labs as Delivery Lead; now owns the phase-2 engagement.
org
Freelance Northwind Labs
role
— empty — Delivery Lead
Change 1 of 5
Kyyn in 96 seconds
Sound on — there's a voiceover
kyyn-explainer.mp4 96 SEC
Why kyyn
The problem isn't storage — it's drift
unseen · unstructured · unchecked
Knowledge drifts

It evolves out of sight — in inboxes, decks and docs nobody re-reads, in formats too loose to hold structure. Nobody notices when it goes wrong.

typed · validated · agreed
Agents need ground truth

Every agent you run tomorrow acts on what the KB says today. Typed, validated facts keep them honest — a chat log or vector store can't.

the learning moment
You stay in the loop

Review isn't just a gate. Every accept extends the context you and your agent share — you see what it learned; it learns what you value.

What people build with it
Eight of many — any knowledge work an agent helps with
An operational memory

Who it serves, why it exists, and a live todo list — grown from mail, calendar and transcripts. The inbox is evidence; the KB is the concise, current memory.

A KB in your vocabulary

Research project, product catalogue, family archive, investment thesis — the schema travels with the KB, no domain compiled into Kyyn itself.

A curated sales view

Curate only strategic accounts and material opportunity changes from Salesforce — the translation happens at the normal review seam.

A recruitment pipeline

CVs, interview transcripts and scorecards land as evidence; candidates, rounds and offers become typed records — every decision traceable to the notes behind it.

A finance memory

Invoices, statements and collection threads curated into obligations with owners and due dates — chased from the record, not the inbox.

A project's ground truth

Standups, boards and decision threads distilled into milestones, risks and commitments — the project's actual state, not its last status deck.

An operations handbook

Runbooks, vendors, renewals and incident history as living records — the tribal knowledge that usually walks out the door with people.

An account memory

Every customer's promises, escalations and renewals curated from mail and meetings — the context a handover actually needs.

How it works — capture → propose → review → trust
01 · CAPTURE
Evidence lands
✉ 48 emails ◷ 12 meetings + transcripts ⌘ Salesforce · SOQL
Append-only ledger. Original bytes, hashed & immutable.
02 · PROPOSE
The agent drafts
UPDJordan Reyes → Northwind Labs
NEWPhase-2 kickoff
SCH+ kind: session
Staged on a Git proposal ref, linked back to its evidence.
03 · REVIEW
You review the diff
JRJordan ReyesUPD
org
Freelance Northwind Labs
Record, schema & source, side by side. You decide.
04 · TRUST
Knowledge that stays useful
◆ facts/
◆ schema/
◆ receipts/
✓ validated on accept
A portable git repo of typed records — yours to keep.
The design doctrine
$ git log --graph doctrine
Six principles, none of them aspirational

Distilled from the doctrine that governs the code. Each one is enforced by mechanism — the accept gate, the repo format, or the plugin boundary — not by convention. All six serve one goal: knowledge that stays correct while agents and humans build it together.

f3a92c1 doctrine/propose-accept HEAD
The agent proposes; the human accepts

Every change — records and schema alike — stages on a scoped Git proposal ref. Nothing reaches the checkout branch until the owner accepts the diff.

agent: stages proposal ref
accept: owner only ✓
8b04e7d doctrine/plain-git
A KB is a self-describing Git repository

Facts, schema, sources and receipts are ordinary files in an ordinary repo — portable, diffable, and readable without kyyn. Git history is the audit trail.

facts/ · schema/ · receipts/
readable without kyyn ✓
c57d10a doctrine/tree-carries-judge
The tree carries its own judge

A KB is a (tree, validator) pair: acceptance runs the tree's own committed WebAssembly validator over the whole result, and pull is fail-closed. Any machine replays the same verdict.

gate: validate(tree, its judge)
pull: fail-closed ✓
2e9b643 doctrine/no-domain
The engine knows no domain

One binary supplies proposals, validation, queries, MCP and the web UI. Every plugin — first-party included — is a tap the KB pins at a commit; even the starter template is fetched, not embedded.

engine: 1 binary · 0 domains
meaning lives in the KB
d14af08 doctrine/custody
Custody, not interpretation

Sources preserve original provider bytes as hashed, immutable evidence. Deciding what evidence means happens only at the reviewed curation seam — which is also how two KBs federate.

evidence: original bytes, hashed
meaning: assigned at review
77c0b25 doctrine/no-migrations
There are no migrations

A schema change and the record rewrites it demands land as one atomic proposal — whole-tree validation forces it. The diff is the migration; the commit is the schema version.

Δ schema + Δ records = 1 diff
commit == schema version
§

Load-bearing, not aspirational. Each principle is mechanism — remove one and the accept gate, the repo format, or the plugin boundary stops holding. The guarantees below are where that enforcement surfaces.

Connect the systems you already use
Every source is a pinned, capability-contained plugin
Microsoft Graph
Mail, calendar, Teams meetings & transcripts, chats, SharePoint files.
File sweep
Files by directory and glob, captured as versioned evidence.
Git repository
Any repo's tree, local or remote, at a ref — glob-swept.
Salesforce
A SOQL query's records as a standing evidence source.
Kyyn KB
Use another team's facts in your own vocabulary — without adopting their schema.
Trust, enforced — not promised
The full trust model →
Plugins can only do what they import
A plugin's typed import list is its entire authority — checked before it runs. Network egress only to hosts you consented to.
Secrets stay with the host
OAuth and API credentials are attached by the engine, outside plugin memory. A compromised plugin has nothing to leak.
Try the beta
Rust · crates.io
$ cargo install kyyn
$ kyyn init my-kb
$ kyyn --kb my-kb web
# review UI on http://127.0.0.1:8787

Register the MCP server and an agent can inspect the schema, curate evidence, and stage proposals. Only you accept them.

Get early access

Kyyn is under active development. Join the waitlist and we'll reach out as onboarding opens.

You're on the list.
We'll be in touch soon.
kyyn— from kin: knowledge that knows what it's related to.How it worksSourcesRoadmap