Something went wrong. Try again.
Something went wrong. Try again.
# 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 …