BrainX Skill

make your coding agent understand the power of BrainX

Requirements

• Node.js 18 or newer
• macOS, Linux, or Windows

Install

npx brainx-skill install

# Claude Code, current project
npx skills add chaobrain/BrainX-skill --agent claude-code

# Codex, current project
npx skills add chaobrain/BrainX-skill --agent codex

# Claude Code, globally
npx skills add chaobrain/BrainX-skill --agent claude-code --global

# Specific project
cd /actual/path/to/project
npx skills add chaobrain/BrainX-skill --agent codex

Update

npx brainx-skill update

When the internet connection is low

# install
npx --registry=https://registry.npmmirror.com brainx-skill install

# update
npx --registry=https://registry.npmmirror.com brainx-skill update

MCP servers

Install and activate every BrainX MCP integration in Codex with one command:

npx brainx-skill mcp install

This installs durable runtimes under ~/.brainx/mcp and registers:

Server	Registration	Purpose
Europe PMC search	europepmc	Search biology and neuroscience literature and retrieve structured article metadata.
Full-text resolver	fulltext_resolver	Resolve PMC, OpenAlex, and bioRxiv/medRxiv full-text versions with provenance.
BrainX Codex reviewer	codex	Run independent BrainX iteration reviews.

The command requires the Codex CLI, a working Codex login, and uv. It refuses to overwrite unrelated registrations. An exact reviewer registration from this repository is retained so its existing approval and timeout settings remain intact. Restart Codex or reload MCP configuration after installation.

Remove only the registrations and runtime owned by this installer:

npx brainx-skill mcp remove

See mcp-servers/fulltext-resolver/README.md and mcp-servers/codex/README.md for tool behavior, configuration, and development setup.

Installation locations

Depending on the selected scope, the canonical brainx-install skill is installed into:

Claude Code: ~/.claude/skills/<skill-name> or <cwd>/.claude/skills/<skill-name>
Codex:       ~/.agents/skills/<skill-name> or <cwd>/.agents/skills/<skill-name>
Cursor:      ~/.cursor/skills/<skill-name> or <cwd>/.cursor/skills/<skill-name>
Windsurf:    ~/.codeium/windsurf/skills/<skill-name> or <cwd>/.codeium/windsurf/skills/<skill-name>
Gemini CLI:  ~/.gemini/skills/<skill-name> or <cwd>/.gemini/skills/<skill-name>
Antigravity: ~/.gemini/config/skills/<skill-name> or <cwd>/.agents/skills/<skill-name>
OpenCode:    ~/.config/opencode/skills/<skill-name> or <cwd>/.config/opencode/skills/<skill-name>

Antigravity reads global skills from ~/.gemini/config/skills and workspace skills from <cwd>/.agents/skills. In project scope that workspace directory is the same one Codex uses, so selecting both harnesses installs the skills once and records them for both.

Installation ownership is recorded in ~/.brainx/receipt.json.