# KNDL — Knowledge Node Data Link

KNDL is the smart format layer for Anthropic Memory: every fact carries confidence, decay, provenance, bitemporal validity, and a supersession chain. One JSON-LD file per fact. Immutable. Works as the format inside Anthropic Memory (filesystem mount) or standalone with SQLite/DuckDB.

## Mental model

Anthropic Memory = WHERE  (filesystem, persistence)
KNDL             = WHAT   (the format of files Claude writes)
kndl-mcp / CLI   = HOW    (query, decay, contradiction detection, provenance)

## Key URLs

- Docs:       https://kndl.artdaw.com/
- Protocol:   https://kndl.artdaw.com/protocol
- Skill:      https://kndl.artdaw.com/skill
- MCP server: https://kndl.artdaw.com/mcp
- Examples:   https://kndl.artdaw.com/examples
- Explorer:   https://kndl.artdaw.com/explorer
- Eval:       https://kndl.artdaw.com/eval
- JSON-LD context: https://kndl.artdaw.com/context/v1.jsonld
- GitHub:     https://github.com/artdaw/kndl

## The fact shape

```json
{
  "@context": "https://kndl.artdaw.com/context/v1.jsonld",
  "@id":      "fact:alice-role-20260426t100000z-ab12cd34",
  "@type":    "Fact",
  "statement": "Alice is a staff engineer on the payments team",
  "subject":   "person:alice",
  "predicate": "role",
  "object":    "staff engineer",
  "confidence": 0.97,
  "decay":      "0.5/180d",
  "source":     "human://gleb",
  "validFrom":  "2026-04-15T00:00:00Z",
  "recordedAt": "2026-04-26T10:00:00Z"
}
```

## MCP tools (9 total)

assert_fact, query_facts, contradictions, supersede_fact, as_of, provenance_chain, sync_memory_store, list_memory_stores, subscribe

## Install

```bash
git clone https://github.com/artdaw/kndl
cd kndl/packages/kndl-memory
pnpm install && pnpm build
node dist/server.js          # stdio MCP server
node dist/server.js --http   # HTTP MCP server on :8000
```

## Skill

Copy skills/kndl-memory/SKILL.md into /memory/skills/ to activate KNDL conventions in Anthropic Memory.