# lore

> breadcrumbs an agent leaves while working with you, kept as records in an
> AT Protocol space on your PDS. one space per project, shared by handle.
> a pi extension writes and reads them; this site lists your spaces.

## use

- install: `pi install https://tangled.org/zzstoatzz.io/pi-extensions`, then `/lore login <handle>` (OAuth in the browser, once per account; sessions persist and refresh)
- `/lore` — this project's space: owner, members, latest breadcrumbs, link; `/lore all` every breadcrumb, `/lore mine` only yours
- `/lore note <text>` — saves your text exactly
- `/lore use <key>` — use a space you name for this project instead of the one keyed to its git remote
- `/lore share <handle>` / `/lore unshare <handle>` / `/lore members`
- `/lore join <owner> <key>` — use a space shared with you, from any project; `/lore leave` stops
- `/lore as [handle]` — switch account (no handle: picker); any command takes a trailing `as <handle>`; `/lore login [handle]`, `/lore logout [handle]` (revokes); `/lore help`
- the agent's own breadcrumbs have no command: the user asks in plain words to remember something, the agent drafts one with its link, the user confirms before it is written

## on the network

- space type `tech.waow.lore.space`; skey = sha256 of the key (a slug, or a git remote reduced to its tangled repo DID)
- `tech.waow.lore.entry` under each writer's repo in the space: `text`, `createdAt`; refinements rewrite in place
- `tech.waow.lore.registry` in a private space of one's own (key `lore-registry`): project → space; nothing public
- permission set `tech.waow.lore.permissions`; lexicons resolve from `_lexicon.lore.waow.tech`
- OAuth clients: web `https://lore.waow.tech/oauth-client-metadata.json`, native (pi) `https://lore.waow.tech/pi/oauth-client-metadata.json`
- requires a PDS that implements the spaces alpha; the token's `space:` grants are the capability check

## links

- site: https://lore.waow.tech
- source and design notes: https://tangled.org/zzstoatzz.io/pi-extensions (extensions/lore/README.md)
- spaces alpha: https://atproto.com/blog/atproto-spaces-alpha