Repository navigation
2.8.0 — Open items in sight, on by default in Claude Code
Open items in sight, for whoever installs CRBRO, not only for its author.
- On by default where Claude Code is, and said out loud.
crbro_boot
installs the mod on its own, once per server process (once per daemon),
when~/.claudeexists: the same install asinstall-modwith the
language on auto. The boot that does it carriesmod_notice, a sentence the
assistant passes on — what was installed, that it shows up in new Claude
Code sessions, and how to remove it — handed to up to three server
processes, once each, within a week, since the first may be a background
run nobody reads. After an update of CRBRO, a boot that finds the installed
files different from the package (SHA-256, line endings aside) refreshes
them without touchingsettings.json, and says so; an older CRBRO on the
same machine never takes back a newer one's files, and two builds of one
version do not rewrite each other. The way out is easy and final:
uninstall-modleaves a mark in~/.claude/crbro-mods/state.jsonand the
mod is never put back on its own, by any client (install-modlifts it);
taking the folder out ofCLAUDE_CODE_PLUGIN_DIRSby hand counts as a no
too, and is said once with the way back;CRBRO_MOD=0turns the automatic
part off for the client whose env sets it, and a daemon started without it
never serves that client. It never fails the boot (files copied without
blocking, 1.5 s at most, every error caught), leaves asettings.jsonthat
does not parse untouched and does not retry the same failure until that
file or the package changes, or a day goes by, installs nothing beside
anothercrbro-pendingalready in the list or when only the environment
setsCLAUDE_CODE_PLUGIN_DIRS(writing it tosettings.jsonwould hide
those plugins; said once), and two sessions starting at once take turns
through an exclusive lock file.settings.jsonis written only if it is
still what was read, with its line endings, and checked after writing:
every key kept, the path listed once. SECURITY.md has a section on it. - The open items above the prompt.
npx crbro-memory install-modadds
crbro-pending, a Claude Code mod: the newest open item of the brain drawn
whole above the prompt — a shortLabel:apart,(1) … (2) …steps one per
line, its age green, amber or red — with ‹ › through the rest, compact/read
all, See all and Hide./pending(alias/pendientes) shows every item
as a card, with a filter that ignores accents, Work on this (the item
written into the prompt, not sent), Done and Discard behind a yes/no,
and what was closed lately. It started as a mod the author kept in his own
~/.claude, reading his brain file by hand and speaking only Spanish. - It asks CRBRO, not the disk. The list comes from
crbro_contextwith no
arguments, which only reads, on whichever MCP server has that tool —
crbroin a standard install, any other name found from the session's tool
list or from the first CRBRO tool the model calls. Only when no server is
reachable does it read<CRBRO_PATH or ~/.crbro>/prefrontal/active_context.json,
resolvingCRBRO_PATHexactly as the server does, and the pane says which
of the two it read. Done and Discard always go through the server; the
mod never writes the brain. - English and Spanish. English by default and Spanish complete, every
string in one table.install-mod --lang en|esstores the choice in the
mod's own setting (a row in/configtoo);autofollowsCRBRO_LANG,
thenLC_ALL/LC_MESSAGES/LANG, then the system locale. - Sturdy with any brain, not only its author's. A colon makes a label only
when it ends a word, so a path, a URL or a time stays whole; an item with
no id reads without a dangling one; the pane draws 40 cards at most and
cuts a line at 2,000 characters, so a large brain never gets it unmounted;
Work on this adds to what was typed instead of replacing it; a CRBRO tool
call waits at most 1.5 s for the band to catch up; a language picked in
/configapplies on reload; a terminal too narrow for the pane says so. - Installed with the same care as the hooks. The mod is copied to
~/.claude/crbro-mods/crbro-pendingand that folder is added once to
env.CLAUDE_CODE_PLUGIN_DIRSin~/.claude/settings.json, with;on
Windows and:elsewhere. A file with a BOM is read, one that does not
parse is left alone, the write is atomic — through a symlink to its target,
with its permission bits and its indentation kept — and a second run
changes nothing. A folder in that list holding a plugin named
crbro-pendientes— the hand-made copy — is replaced in place and named,
and its folder is left on disk. Any other copy (anothercrbro-pendingin
the list, or one in~/.claude/mods) is pointed out and never touched.
uninstall-modremoves the entry (and the variable, and anenvblock,
when they end up empty), puts back thecrbro-pendientesfolder it had
replaced if it is still there, and deletes its own folder, nothing else.
Folders that only the shell'sCLAUDE_CODE_PLUGIN_DIRSlists are named,
never merged in silence. - Verified like the hooks.
install-mod --verify, andinstall-hooks --verifytoo, compare the installed copy with the package file by file by
SHA-256 and check thatsettings.jsonlists it; a file the package does
not ship, or a second copy Claude Code would also load, is a difference
too. Exit 1 on any. - Requirement. Mods need Claude Code 2.1.286 or later, and are drawn in the
CLI and in the desktop app's Code tab — not in Claude Desktop chat, Codex,
Cursor or the VS Code extension. A new session picks the mod up. - Package.
mods/ships; the mod's tests,tsconfig.jsonand generated
types do not (mods/crbro-pending/.npmignore). The mod's tests run under
claude plugin test, the installer's in the vitest suite, which leaves
mods/to the former. - A new tour at the top of the README.
docs/crbro-tour.gifreplaces the
August demo: memory across sessions, corrections that replace old facts,
secrets kept out, the guard, the compaction checkpoint and the band.
docs/pending-band.gifshows the band and/pendingat work. Both are drawn
by code with made-up data; every figure on screen is one this README states.
Install / update: claude mcp add --scope user crbro -- npx -y crbro-memory · Claude Desktop: double-click crbro-memory-2.8.0.mcpb below.
