@mindmux/brain-md v0.1.0

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.

Highlights

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

Or without a global install:

npx @mindmux/brain-md setup -y
npx @mindmux/brain-md init

• Single command surface: brain setup / uninstall (machine) and brain init / wire / page commands (project).
• Default wire: brain init scaffolds protocol + empty brain (brainRoot-aware) and wires agent config without whole-file overwrite.
• Lean package: skills + CLI only; zero runtime dependencies.

Agent support

Skills install into common agent skill dirs (e.g. Claude Code, Codex, Cursor, Pi, OpenCode — per installer targets).

Correct-by-construction CLI

• Reads: brain-dir, list-pages, read-page, read-root
• Writes: create-page, update-truth, append-timeline, update-root, …
• Optional pre-commit hook: reindex + lint-links
• brainRoot via .mindmux/preferences.json (MindMux sidecars) — no split-brain local scaffold

Publishing / CI

• Package name: @mindmux/brain-md
• Tag-driven publish: push vX.Y.Z (must match package.json version)
• CI test matrix: Node 18 / 20 / 22

Install notes

• Prefer global install if you want bare brain on PATH. npx alone does not leave brain on PATH — use npx @mindmux/brain-md … for both steps, or global install.

• If an old local/global brain-md (unscoped) is installed, uninstall it first to avoid EEXIST on the brain bin:

  npm uninstall -g brain-md
  npm install -g @mindmux/brain-md

Docs

• README: quick start + CLI overview
• BRAIN.md (after brain init): full read/write contract
• Skills: brain-setup, brain-bootstrap, brain-page, brain-ingest

Links

• npm: https://www.npmjs.com/package/@mindmux/brain-md
• Repo: https://github.com/mindmuxai/brain.md
• Homepage: https://projectbrain.md

License

Apache-2.0 · Incubated by MindMux

What's Changed

• Use second-precision timestamps for page creation by @robinv8 in #1
• Fix brain index list rendering by @LinkinStars in #2
• fix(brain-page): fix compiled_truth section boundaries and lint-links scope by @robinv8 in #3
• Add OpenCode agent support by @tranch in #4
• Add Cursor and Pi agent support by @shujing-H in #7
• Update brain page section markers by @LinkinStars in #9
• feat: default wire, brain init, and npm install path by @robinv8 in #11
• ci: test matrix + npm publish on v* tags by @robinv8 in #13
• fix: publish as @mindmux/brain-md by @robinv8 in #14
• ci: harden npm publish auth for @mindmux by @robinv8 in #15
• ci: publish via npm Trusted Publisher (OIDC) by @robinv8 in #16
• ci: restore token-based npm publish by @robinv8 in #17

New Contributors

• @robinv8 made their first contribution in #1
• @LinkinStars made their first contribution in #2
• @tranch made their first contribution in #4
• @shujing-H made their first contribution in #7

Full Changelog: https://github.com/mindmuxai/brain.md/commits/v0.1.0