7.9 kB · 149 lines
Markdown
at main

# lore breadcrumbs an agent leaves while working with you: a source worth returning to, a decision and its reason, a preference. each carries the link that makes it usable. they are records in a [space](https://atproto.com/blog/atproto-spaces-alpha) on your PDS, one space per project, shared by handle, readable by any client that can read the space. **live:** [lore.waow.tech](https://lore.waow.tech) lists your spaces and what is in them. [llms.txt](https://lore.waow.tech/llms.txt). **package:** [@waow.tech/lore](https://www.npmjs.com/package/@waow.tech/lore). ## use ``` pi install npm:@waow.tech/lore /lore login you.example.com ``` once per account: a browser tab opens on your PDS, you approve the lore permission set, and the token that comes back is scoped to it. sessions persist under the agent dir and refresh on their own. then, in a pi session inside a project: | | | | --- | --- | | `/lore` | this project's space: owner, members, a few lines, a link to it on pds.ls. `all`, `mine` | | `/lore note <text>` | your text, exactly as typed | | `/lore use <key>` | use a space you name for this project instead of its own | | `/lore share <handle>` | let someone read it and add to it; `unshare` takes it back, `members` lists them | | `/lore join <owner> <key>` | use a space someone shared with you; `leave` stops using it here | | `/lore as` | switch account; `/lore logout` revokes one; `/lore help` for the rest | the agent's own breadcrumbs have no command: ask it in plain words to remember something and it drafts one from context, with its link; you confirm before it is written. typing `/lore ` opens a picker of subcommands; handles complete from [typeahead](https://typeahead.waow.tech) wherever one is typed, accounts from the ones you have logged into. the footer shows `● lore key · n · account` for your own space, `◇ lore key ← owner` for a shared one, `○ lore · unbound` for none. sharing is two acts, as the protocol makes it: the owner adds a handle, and tells the member the key. the member joins from any …