codex-brain-mcp
v0.1.0
Published
Persistent local Markdown memory for Codex, compatible with Obsidian.
Maintainers
Readme
Codex Brain
Persistent, local, Obsidian-compatible memory for Codex. This Codex adaptation combines an MCP server, a reusable brain-sync skill, and optional AGENTS.md guidance.
Derived from Virul Wickramasinghe's MIT-licensed claude-setup. See NOTICE.
Install
npx -y codex-brain-mcp --install
codex mcp add codex-brain -- npx -y codex-brain-mcpRestart Codex or VS Code, then ask: Use Codex Brain to initialize the vault and report its status. The default vault is ~/Documents/Obsidian/Codex Brain; override it with CODEX_BRAIN_PATH.
Tools: brain_status, brain_search, brain_read, brain_capture.
The first command installs the brain-sync Codex skill, enabling explicit $brain-sync use and implicit activation when its description matches. Add AGENTS.fragment.md to your global or project AGENTS.md if you want stronger automatic recall/capture guidance.
The server never pushes notes to Git automatically. If you sync the vault, use a private repository and review notes for secrets first.
Publish
npm publish --access public publishes codex-brain-mcp to npmjs. A GitHub release can run that flow using an NPM_TOKEN repository secret. Tagging v* publishes the scoped package to GitHub Packages using GITHUB_TOKEN.
