Skill Detail

Give coding agents repo-local project memory with brain.md

Initialize and maintain a repo-native Markdown memory layer so coding agents preserve durable decisions, requirements, constraints, and rationale across sessions.

Developer ToolsMulti-Framework
Developer Tools Multi-Framework Security Reviewed
⭐ 438 GitHub stars ⬇ 92/wk npm
COPY SKILL INSTRUCTIONS (OPTIONAL)
npx skills add agentskillexchange/skills --skill give-coding-agents-repo-local-project-memory-with-brain-md Copy
Uses the third-party skills CLI, not an ASE-owned installer. Check your agent’s compatibility. This copies instructions; complete the upstream tool setup below separately.
At a glance
Tools required
Node.js, npm or npx, git repository, supported coding agent that reads project instruction files
Install & setup
Install with npm install -g @mindmux/brain-md, run brain setup -y, then initialize a target project with brain init. For one-off use, run npx @mindmux/brain-md setup -y and npx @mindmux/brain-md init.
Author
MindMux AI
Publisher
Organization
Last updated
Aug 13, 2026
Quick brief

Use brain.md when an agent needs durable project memory that lives with the repository instead of vanishing into chat history. The operator initializes a project with `brain init`, wires agent instructions, seeds durable knowledge with the bundled skills, then reads and writes decisions, constraints, and rationale through the `brain` CLI. Invoke this instead of using the product normally when the job is to preserve cross-session project context for future agents, not to browse notes or run a generic knowledge-management app. The boundary is the repo-local Markdown brain protocol and CLI-managed read/write workflow; it is not a generic memory SDK, vector database, or hosted workspace listing.

How it works

What this skill actually does

Inputs and prerequisites: Node.js, npm or npx, git repository, supported coding agent that reads project instruction files.

Setup notes: Install with npm install -g @mindmux/brain-md , run brain setup -y , then initialize a target project with brain init . For one-off use, run npx @mindmux/brain-md setup -y and npx @mindmux/brain-md init .

Source and verification boundary: use https://projectbrain.md as the canonical reference before running the workflow; keep commands, API calls, CLI usage, and generated outputs reviewable against that upstream source.

Framework fit: publish this as a Multi-Framework workflow only when the operator can invoke the documented toolchain directly, rather than treating the upstream project as a generic product listing.