codex

Codex Brain

Local-first persistent memory plugin for Codex: a vault with transaction-reviewed writes, source/claim provenance ledgers, and onboarding/assistant skills that propose content instead of writing on their own.

0 on GitHubby Guilherme Mourãov0.5.0updated 3 months agoProductivity

Plugin codex-brain in guipmourao/agents. Commands read from the repo's manifest — 1 month ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (11)

  • brain-assistant

    Ongoing work-support hub for a codex-brain after first-time setup: surface what matters from the vault, draft replies, and offer follow-up help. Use when the user resumes a working session with this vault, asks what they should know, or wants proactive awareness of open items. Triggers: what should

  • brain-ingest

    Turn a supplied source (file, pasted text, or approved URL) into grounded, cross-linked vault pages without altering the source. Use when the user hands over material to process. Triggers: ingest this, process this file, add this source.

  • brain-init

    Initialize a new vault or adopt an existing directory as a codex-brain. Use for first-time setup, adding memory to an existing repo, or choosing a vault when multiple exist. Triggers: set up vault, adopt this repo, init memory, first-time setup.

  • brain-lint

    Run a deterministic health check on the vault: dead links, orphan pages, missing frontmatter, duplicate basenames, stale index entries, and provenance errors. Read-only — never writes. Use when the user asks to check vault health, find broken links, or clean up the wiki. Triggers: check the vault, l

  • brain-loop

    Set up a recurring, bounded check against this vault, orchestrated by an external scheduler (cron, CI) calling `codex exec`. Use when the user wants a periodic check-in, a recurring monitor, or a follow-up that repeats on a cadence. Triggers: check this again later, monitor this, remind me periodica

  • brain-new-person

    Create or update a person note under wiki/people/ from a template. Use when the user asks to add a collaborator, remember someone's preferences, or bootstrap a wiki/people/<name>.md file. Triggers: add a person, remember this about someone, create a people note.

  • brain-new-project

    Bootstrap a new project or experiment directory with a README and optional PROJECT_AGENTS.md. Use when the user asks to start a project, start an experiment/spike, or scaffold a workspace entry. Triggers: new project, start an experiment, scaffold a project folder.

  • brain-onboarding

    First-run setup for a codex-brain: initializes the vault if one does not exist yet, understands the workspace, asks what projects and people matter, checks for useful connected tools, and proactively proposes wiki/people/ and wiki/projects/ notes for approval. The single entry point for starting a n

  • brain-query

    Answer a question using only existing vault knowledge. Read-only — never writes. Use for recall questions about the vault's own content. Triggers: what do we know about, search the vault, what did we decide about.

  • brain-save

    Save a user-selected answer, decision, insight, or session result into the vault as one reviewed transaction. Use only when the user explicitly asks to preserve specific conversation content. Triggers: save this, keep this insight, file this decision, preserve this result.

  • brain-write-like-me

    Bootstrap a personal writing-style profile from the user's own sent messages (email, chat, or pasted samples), for use later when drafting text in their voice. Use when the user asks to learn their writing style, capture their voice, or create a write-like-me profile. Triggers: learn my writing styl

Hooks (2)

  • SessionStart

    python3 "${PLUGIN_ROOT}/skills/brain-init/scripts/vault.py" hook session-start

  • Stop

    python3 "${PLUGIN_ROOT}/skills/brain-init/scripts/vault.py" hook stop

View source on GitHub

More from guipmourao/agents

All 2 plugins →

Data engineering workflows for dimensional modeling, data warehouse design, data quality, ETL, ELT, and analytical architecture.

1 skill

0

Similar plugins

caveman

claude

Talk like caveman. Cut filler. Keep technical details explicit.

22 skills · 1 command · 3 agents · hooks

JuliusBrussee/caveman 119,462

claude-mem

claudecodex

Persistent memory for Claude Code: the next session starts where the last one left off.

29 skills · 1 MCP server · hooks

thedotmack/claude-mem 116,618

Taste Skill

claudecodex

tasteskill 2.5.1: professional company websites at the figma.com and x.ai level, with one section per screen, real photographs, real product UI, effects kept for tech and gaming pages, and a real-browser checker and finish gate.

1 skill

Leonxlnx/taste-skill 114,391

career-ops

claudecodex

Open-source AI job search that runs locally in your AI coding CLI: scan job portals, evaluate listings into a structured A-H report with a 1-5 score, tailor your CV, track applications

5 skills · hooks

career-ops-hq/career-ops 82,253

mem0

claudecodex

Cross-session memory and token savings for coding agents.

6 skills · 1 agent · 1 MCP server · hooks

mem0ai/mem0 68,893

pake

claudecodex

Package any website or local web build into a lightweight desktop app with Pake CLI.

1 skill

tw93/Pake 63,463

Maintain Codex Brain?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins2 plugins