Store · Lore
Leave a note.
Every future agent picks it up.
Tell your AI "always start with the conclusion" once. Every future session reads it before working.
Seed a lore note once. Every future agent in the same project pulls it automatically, at the right trigger, scoped to the work it's about to do.
Why
Onboarding rounds, every session.
An agent walks into a fresh session and spends the first ten minutes rediscovering things every previous agent already learned: which test command works, which file blew up last time, which branch is the canonical one.
A lore note is a one-line entry about that. The next agent reads it at the right moment and skips the discovery. Lessons and lived experiences of you and your agent, codified so you don't have to learn them twice.
CLI
Add, query, list, delete.
$ greprag lore add "Tests run from repo root, not packages/api" --scope chip-startup $ greprag lore add "Migration 037 changed node_id to composite FK" --scope migrations-touch $ greprag lore add "Default branch is main, not master" --scope general $ greprag lore query --scope chip-startup $ greprag lore list $ greprag lore scopes $ greprag lore delete a4f9c2e1
Scopes
Routed by trigger, not by topic.
A scope is a tag that says "read me at this kind of moment." Three live today; more come online as injectors land.
chip-startup Pulled when a chip spawns. The chip sees the relevant lore in its initial context.
<subsystem>-touch Pulled before an Edit/Write whose file path matches a registered pattern. Just-in-time onboarding for the surface the agent is about to touch.
general Pulled at session start in known projects. The "always read this first" pile.
Sources
Three ways a lore note gets seeded.
1
Agent, in real time
The agent hits friction. It writes a lore note about that friction before continuing. The skill teaches when to seed: three signatures of discovery waste — repeated lookups, repeated failures, repeated clarifications.
2
You, deliberately
You notice a thing every agent should know. You run greprag lore add with the right scope.
That's it.
3
Hourly cron, as backstop
A parallel extractor scans turn envelopes for discovery-waste signatures the agent missed in the moment. Candidates land in your inbox as a digest. You review, accept, ingest.
The loop
It closes itself.
chip hits friction → seeds lore note (real-time, in-session)
↘
hourly cron catches what was missed → inbox digest
↗
user reviews → ingests into lore store
↓
next chip queries scope=chip-startup → spawns fully armed Same loop, three entry points. The lore store is the resting state. Discovery waste flows in; ready-state lore flows out at the next trigger.
Use case
"Tests run from repo root, not packages/api."
A chip spawns to add a test. It tries cd packages/api && node tests/... and the env vars don't load.
It debugs for two minutes, figures out the test must run from repo root, fixes the path, ships.
Before continuing, the chip writes the lore note. Three days later, a different chip spawns for similar
work. It pulls scope=chip-startup in its initial context. It sees the note. It uses the
right path on the first try.