kb

notes and sources for coding agents.

install

bun add --global github:hraness/kb#v0.9.0

about

Markdown stores sources, notes, and plans for Obsidian and Git.

save pages and PDFs as folders containing the original PDF, readable text, and extracted images.

filter fields, show which notes link back, and search on your computer by exact words or similar meaning. a disposable local Datalog graph can query exact structure and percolate reusable concepts and named relationships.

use

kb init kb
kb agents identity src
kb context src/index.ts --root kb --repo .
kb clip https://example.com/article --output articles
kb pdf ./report.pdf --output articles
kb percolate notes/topic --root .
kb relation add notes/topic supports notes/durable-memory --root .
kb datalog '[:find ?tag :where [?note :note/tag ?tag]]' --root .
kb backlinks notes/topic --root .
kb links notes/topic --root . --direction both
kb search "what changed?" --root .