Project memory
What the team learns about a repository is kept as markdown in that repository, under .lucitra/.
You can read it, diff it and correct it like any other file, and it travels with the repository.
It holds reasoning, never source code: decisions, how the repository works, what was tried.
How it changes
Agents never write to it directly. While a task runs, an agent can propose something worth remembering. The proposals are held until the work is delivered, then arrive together as one pull request, separate from the code change. A person merges it or closes it.
A proposal you have already rejected is not offered again.
Read it
lucitra ask "how do we version the public API?" # searches it first
lucitra brain-pages # every page, with what it links to
lucitra brain-page <path> # one page, by the path brain-pages lists
lucitra brain-history # every commit that touched it
The app shows the same pages as a graph and a reader.
Read a shared brain
A brain can also be a whole repository, with its pages at the root, like a company's shared knowledge base. Register it and switch brain reads to it:
lucitra brain-add ~/company-brain company # a folder whose pages sit at its root
lucitra brain-use company # brain-pages, brain-page, brain-history and ask read it
lucitra brains # every registered brain; * marks the one in use
lucitra brain-use repo # back to this repository's own .lucitra/
lucitra brain-remove company # forget it; the folder is left as it is
Folders that hold no pages are skipped: raw/, Clippings/, skills/, scripts/ and any folder
starting with a dot. What agents propose to remember still goes to the repository they work in.
A team can name its brain in its DIRECTION.md, as brain: your-org/company-brain. While that team
is selected, reads use that brain whatever brain-use says, once a clone of it is registered.
lucitra brains says which brain is in use and why. The order is: the selected team's brain, then
the one brain-use chose, then the repository's own.
What it is not
It is not a copy of your code, and it is not stored anywhere but your repository. See What leaves your machine.