Skip to content

2.8.0 — Open items in sight, on by default in Claude Code

Choose a tag to compare

@Octonove Octonove released this 04 Oct 08:53
· 92 commits to master since this release

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 ~/.claude exists: the same install as install-mod with the
    language on auto. The boot that does it carries mod_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 touching settings.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-mod leaves a mark in ~/.claude/crbro-mods/state.json and the
    mod is never put back on its own, by any client (install-mod lifts it);
    taking the folder out of CLAUDE_CODE_PLUGIN_DIRS by hand counts as a no
    too, and is said once with the way back; CRBRO_MOD=0 turns 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 a settings.json that
    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
    another crbro-pending already in the list or when only the environment
    sets CLAUDE_CODE_PLUGIN_DIRS (writing it to settings.json would hide
    those plugins; said once), and two sessions starting at once take turns
    through an exclusive lock file. settings.json is 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-mod adds
    crbro-pending, a Claude Code mod: the newest open item of the brain drawn
    whole above the prompt — a short Label: 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_context with no
    arguments, which only reads, on whichever MCP server has that tool —
    crbro in 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,
    resolving CRBRO_PATH exactly 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|es stores the choice in the
    mod's own setting (a row in /config too); auto follows CRBRO_LANG,
    then LC_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
    /config applies 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-pending and that folder is added once to
    env.CLAUDE_CODE_PLUGIN_DIRS in ~/.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 (another crbro-pending in
    the list, or one in ~/.claude/mods) is pointed out and never touched.
    uninstall-mod removes the entry (and the variable, and an env block,
    when they end up empty), puts back the crbro-pendientes folder it had
    replaced if it is still there, and deletes its own folder, nothing else.
    Folders that only the shell's CLAUDE_CODE_PLUGIN_DIRS lists are named,
    never merged in silence.
  • Verified like the hooks. install-mod --verify, and install-hooks --verify too, compare the installed copy with the package file by file by
    SHA-256 and check that settings.json lists 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.json and 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.gif replaces 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.gif shows the band and /pending at 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.

Open items band