brain
v0.6.0Shared Git-backed knowledge, session continuity, graph context, and wiki maintenance for coding agents.
By Mason BeardLicense: MIT1 GitHub starsUpdated 1 hour ago
Directory evidence
- Runtimes
- Codex, Claude Code, and Agent Plugins
- Parsed components
- 10 skill or MCP entries
- Source updated
- Sep 28, 2026
- Manifest status
- Canonical path parsed
The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →
Install brain for Codex and Claude Code
codex plugin marketplace add IchenDEV/agent-plugin-mkt
codex plugin marketplace upgrade agent-plugin-marketplace
codex plugin add brain@agent-plugin-marketplacePaste and run these commands in a terminal with Codex. They add and refresh the PluginsMP catalog, then install this plugin.
Compatibility: the page URL and API slug “brain-2” remain stable.
- Codex:
brain-2@agent-plugin-marketplace→brain@agent-plugin-marketplace
The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.
Get the source manually
git clone https://github.com/karch4162/agent-infraClone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is brain/.
Plugin files
├── .codex-plugin/plugin.json├── .claude-plugin/plugin.json├── plugin.json├── skills/consolidate/SKILL.md├── skills/doctor/SKILL.md├── skills/freshness/SKILL.md├── skills/init/SKILL.md├── skills/label/SKILL.md├── skills/promote/SKILL.md├── skills/resume/SKILL.md├── skills/save/SKILL.md├── skills/tidy/SKILL.md└── skills/wiki-ingest/SKILL.md
Included Skills10
Turn ONE named wiki-graph community into a synthesis DRAFT (a claim with sources, not a membership list), proposing an amendment when the community already holds a bridges/ or meta/ note, and queueing contradictions between its members for review. Keyless, in-session; writes only wiki/_drafts/ + logs/. Trigger: /brain:consolidate <community> (or --all), or 'consolidate this community' / 'synthesize this cluster'.
Diagnose and repair brain health — graphify install/launcher/version drift, the vault binding (BRAIN_ROOT), the registry, and stale interpreter caches. Trigger: /brain:doctor, or 'the graph/graphify is broken', 'check brain health', 'fix graphify'.
Run the brain wiki health check (POC §8 freshness agent): orphans, dead [[links]], stale last_verified, broken source anchors. Produces a review queue, never auto-deletes. Trigger: /brain:freshness, or 'lint the wiki' / 'check the brain for rot'.
Set up the brain for a project: ensure graphify is installed, pick (or register) the target vault from the brain registry, scaffold a new vault if needed, and wire this project to it. Trigger: /brain:init, or 'set up the brain here' / 'connect this repo to a brain'.
Name a graph mirror's communities vault-side — no repo checkout, no resync. Reads graphify/<repo>/graph.json, names clusters in-session (keyless), rewrites <repo>-GRAPH_REPORT.md preserving existing names, regenerates stubs. Trigger: /brain:label [repo ...], or 'label the communities' / 'fix the unlabeled mirrors'.
Guided draft→trusted promotion: triage wiki/_drafts/ (keep / merge / drop), validate frontmatter, file into the right wiki area + index, and stage the batch as a PR. Never auto-promotes — the human is the gate; the PR is the promotion. Trigger: /brain:promote [draft-name|all], or 'promote the drafts' / 'graduate the drafts'.
Load prior brain session context before starting work. Reads the most recent logs/ entries, the hot.md cache, and relevant wiki notes so the agent picks up where the last session left off. Trigger: /brain:resume (when working in a brain vault).
Persist the current brain working session: write a dated session log, refresh the hot.md cache, append to the operation log, and sync any changed graph mirrors. Trigger: /brain:save (when working in a brain vault).
Apply the mechanical tier of a freshness report as one reviewed batch: re-anchor moved source: paths, index orphans via hub notes, fold singleton tags. Never deletes notes or edits facts — judgment findings stay in the queue. Trigger: /brain:tidy, or 'fix the freshness findings' / 'clean up the wiki'.
Distill harvested Claude Code session digests (chats/) into DRAFT wiki notes for review. The LLM half of the harvest pipeline; honors the POC governance rule that auto-ingested knowledge stays in staging until PR-promoted. Trigger: /brain:wiki-ingest, or 'ingest the harvested chats'.
Plugin manifests3
{
"name": "brain",
"version": "0.6.0",
"description": "Shared Git-backed knowledge, session continuity, graph context, and wiki maintenance for coding agents.",
"author": {
"name": "Mason Beard",
"email": "[email protected]"
},
"skills": "./skills/",
"interface": {
"displayName": "Brain",
"shortDescription": "Shared knowledge and session continuity.",
"longDescription": "Shared Git-backed knowledge, session continuity, graph context, and wiki maintenance for coding agents.",
"developerName": "Mason Beard",
"category": "Productivity",
"capabilities": [],
"defaultPrompt": "Use Brain to resume context and preserve the decisions from this task."
}
}{
"name": "brain",
"version": "0.6.0",
"description": "The Brain — a git-backed, agent-queryable knowledge substrate. Ships the 3-step graph→wiki→raw query rule (as a CLAUDE.md template), the /init /save /resume /freshness /tidy /label /consolidate /promote /wiki-ingest /doctor skills, a self-gating graph-before-grep PreToolUse hook, the vault directory scaffolding + bin scripts, and a multi-vault registry for init-time vault selection (personal vs team). Depends on the graphify CLI (delegated, not vendored). Neutral BRAIN_ROOT contract for consumers.",
"author": {
"name": "Mason Beard",
"email": "[email protected]"
},
"license": "MIT",
"homepage": "https://github.com/karch4162/agent-infra",
"keywords": [
"knowledge-graph",
"graphify",
"obsidian",
"memory",
"rag",
"second-brain",
"agent-context",
"wiki",
"freshness",
"provenance"
]
}{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "brain",
"version": "0.6.0",
"description": "Shared Git-backed knowledge, session continuity, graph context, and wiki maintenance for coding agents.",
"author": {
"name": "Mason Beard",
"email": "[email protected]"
}
}For maintainers
If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.
[brain on Agent Plugins Marketplace](https://pluginsmp.com/plugins/brain-2)