# Brain Ops

> Brain-first local memory workflow for Codex. Use to search, update, cite, or cross-link the local brain before outside research or after new user signal.

- Skill: `mphaxise/brain-ops` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mphaxise/brain-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mphaxise/brain-ops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: mphaxise (https://skillmd.com/u/mphaxise)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mphaxise/brain-ops

---


# Brain Ops

Use this skill when the user wants memory-grounded work and the local `brain/` corpus should influence the response or capture new context.

This port is adapted from `garrytan/gbrain` at commit `0b47afbf402a4e27a648bb9d131ce584461461ea`.

## Important Adaptation

Upstream GBrain treats brain ops as an ambient behavior layer. In this repo, the equivalent is an explicit workflow backed by local file operations:

- `python3 scripts/brain_search.py "<query>"`
- `python3 scripts/brain_put.py ...`
- `python3 scripts/brain_link.py ...`
- `python3 scripts/brain_citations.py`

## Workflow

1. Check the local brain first:
   - search for the entity, topic, or project
   - read the top matching pages before doing outside research
2. If the user shared new information, write it back:
   - create or update the right page under `brain/`
   - add a dated timeline entry
3. Maintain graph hygiene:
   - add backlinks for referenced people, companies, meetings, or concepts
   - keep inline `[Source: ...]` citations on any new fact
4. Answer or continue the task using the retrieved context.

## Current Upstream Coverage

Enforce the brain-first loop on inbound and outbound work: read relevant context, enrich or write durable signals, update structured relationships, then answer from refreshed context. Every new durable page must backlink to its source or parent context; cross-source answers must identify which source supports each claim.

## Guardrails

- Do not claim this is always-on ambient capture; run it deliberately.
- Do not use external research before checking the local brain when the task is memory-sensitive.
- Do not invent citations or backlinks just to satisfy formatting.