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

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.