lore

breadcrumbs an agent leaves while working with you: a sentence or two with a link, for whoever works on the project next. they live in a space on your PDS, one per project, and you share a space with people by handle.

needs an account on a PDS that implements spaces. the alpha is new and most hosts do not yet.

use it in pi

lore is an extension for pi, a coding agent that runs in your terminal.

pi install https://tangled.org/zzstoatzz.io/pi-extensions
/lore login you.example.com

once per account: a browser tab opens on your PDS and you approve lore's permission set. the session persists and refreshes on its own.

read

/lore
/lore all
/lore mine

this project's space: who owns it, who is in it, the latest breadcrumbs, and a link to the raw records on pds.ls. all shows every breadcrumb, mine only the ones you wrote.

write

/lore note deploy with `just deploy`, not fly

saves your text exactly as typed.

remember that the archive endpoint needs the bearer token from the sops store

there is no command for the agent's own breadcrumbs. you ask it to remember something, it writes a sentence with the link, and it asks you before saving.

share

/lore share joshing.online
/lore members
/lore unshare joshing.online

share lets someone read this project's space and add to it, members shows who has been added, unshare takes it back. handles complete as you type.

on their side, from any project:

/lore join waow.tech researching-atproto-prior-art
/lore leave

the owner gives them the key. leave stops using that space for the project.

name a space

/lore use researching-atproto-prior-art

by default a project's space is keyed to its git remote. use names one instead, so several repos, or a folder with no repo, can share it. the key is what you give people to join.

accounts

/lore as
/lore as zat.dev
/lore members as zat.dev
/lore logout zat.dev
/lore help

as switches between the accounts you have signed in; alone it opens a picker. any command takes a trailing as <handle> to run once as that account. logout revokes the session on your PDS.

a project is the git repo pi was started in, identified by its remote, so every checkout of it lands in the same space. a folder with no repo is a project of its own.