First public release of @mindmux/brain-md

A persistent memory layer for coding agents: durable project decisions as Markdown, read and written through one zero-dependency brain CLI.

Highlights

  • First public release on npm under the @mindmux scope: a persistent memory layer for coding agents — durable project decisions as Markdown, read and written through one zero-dependency brain CLI.
  • Install-first toolkit, no clone required:
npm install -g @mindmux/brain-md
brain setup -y          # install skills into detected agents
brain init              # in a project: BRAIN.md + brain/ + wire CLAUDE.md / AGENTS.md
  • Single command surface: brain setup / uninstall for the machine, brain init / wire / page commands for the project.
  • Skills install into common agent skill dirs (Claude Code, Codex, Cursor, Pi, OpenCode).
  • Correct-by-construction CLI: reads (brain-dir, list-pages, read-page, read-root) and writes (create-page, update-truth, append-timeline, update-root), with an optional pre-commit hook for reindex + lint-links.

Install notes

  • Prefer a global install if you want bare brain on PATH; npx alone does not leave brain on PATH.
  • If an old unscoped brain-md is installed globally, uninstall it first to avoid EEXIST on the brain bin.

Related links

Share to