ucitra/ agent teams

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.

Cookie settings

Choose what this site may store in your browser. You can change it any time from Cookie settings at the bottom of every page.

EssentialAlways on

Remembers the choice you make here. Nothing else is stored until you turn analytics on.

What is stored
NameWherePurposeKept
lucitra-consentLocal storageYour analytics choiceUntil you clear it
Analytics

Shows us which pages people read, what breaks, and which links bring people here, so we know what to fix. Off until you turn it on.

What is stored
NameWherePurposeKept
ph_<key>_posthogCookieA random identifier for your browser, and the current session1 year
ph_<key>_posthogLocal storageThe same identifier, as a backup to the cookieUntil you clear it
lucitra-last-touchSession storageThe link or campaign that started this visit, sent only with a contact form messageUntil you close the tab
lucitra-first-touchLocal storageThe link or campaign of your first visitUntil you clear it
lucitra-last-touchLocal storageThe link or campaign of your latest visitUntil you clear it
Cookie policy