Files

uroma 7a491b1548 SuperCharge Claude Code v1.0.0 - Complete Customization Package

Features:
- 30+ Custom Skills (cognitive, development, UI/UX, autonomous agents)
- RalphLoop autonomous agent integration
- Multi-AI consultation (Qwen)
- Agent management system with sync capabilities
- Custom hooks for session management
- MCP servers integration
- Plugin marketplace setup
- Comprehensive installation script

Components:
- Skills: always-use-superpowers, ralph, brainstorming, ui-ux-pro-max, etc.
- Agents: 100+ agents across engineering, marketing, product, etc.
- Hooks: session-start-superpowers, qwen-consult, ralph-auto-trigger
- Commands: /brainstorm, /write-plan, /execute-plan
- MCP Servers: zai-mcp-server, web-search-prime, web-reader, zread
- Binaries: ralphloop wrapper

Installation: ./supercharge.sh

2026-01-22 15:35:55 +00:00

3.3 KiB

Raw Blame History

Superpowers for Codex

Complete guide for using Superpowers with OpenAI Codex.

Quick Install

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

Manual Installation

Prerequisites

OpenAI Codex access
Shell access to install files

Installation Steps

1. Clone Superpowers

mkdir -p ~/.codex/superpowers
git clone https://github.com/obra/superpowers.git ~/.codex/superpowers

2. Install Bootstrap

The bootstrap file is included in the repository at .codex/superpowers-bootstrap.md. Codex will automatically use it from the cloned location.

3. Verify Installation

Tell Codex:

Run ~/.codex/superpowers/.codex/superpowers-codex find-skills to show available skills

You should see a list of available skills with descriptions.

Usage

Finding Skills

Run ~/.codex/superpowers/.codex/superpowers-codex find-skills

Loading a Skill

Run ~/.codex/superpowers/.codex/superpowers-codex use-skill superpowers:brainstorming

Bootstrap All Skills

Run ~/.codex/superpowers/.codex/superpowers-codex bootstrap

This loads the complete bootstrap with all skill information.

Personal Skills

Create your own skills in ~/.codex/skills/:

mkdir -p ~/.codex/skills/my-skill

Create ~/.codex/skills/my-skill/SKILL.md:

---
name: my-skill
description: Use when [condition] - [what it does]
---

# My Skill

[Your skill content here]

Personal skills override superpowers skills with the same name.

Architecture

Codex CLI Tool

Location: ~/.codex/superpowers/.codex/superpowers-codex

A Node.js CLI script that provides three commands:

bootstrap - Load complete bootstrap with all skills
use-skill <name> - Load a specific skill
find-skills - List all available skills

Shared Core Module

Location: ~/.codex/superpowers/lib/skills-core.js

The Codex implementation uses the shared skills-core module (ES module format) for skill discovery and parsing. This is the same module used by the OpenCode plugin, ensuring consistent behavior across platforms.

Tool Mapping

Skills written for Claude Code are adapted for Codex with these mappings:

TodoWrite → update_plan
Task with subagents → Tell user subagents aren't available, do work directly
Skill tool → ~/.codex/superpowers/.codex/superpowers-codex use-skill
File operations → Native Codex tools

Updating

cd ~/.codex/superpowers
git pull

Troubleshooting

Skills not found

Verify installation: ls ~/.codex/superpowers/skills
Check CLI works: ~/.codex/superpowers/.codex/superpowers-codex find-skills
Verify skills have SKILL.md files

CLI script not executable

chmod +x ~/.codex/superpowers/.codex/superpowers-codex

Node.js errors

The CLI script requires Node.js. Verify:

node --version

Should show v14 or higher (v18+ recommended for ES module support).

Getting Help

Report issues: https://github.com/obra/superpowers/issues
Main documentation: https://github.com/obra/superpowers
Blog post: https://blog.fsck.com/2025/10/27/skills-for-openai-codex/

Note

Codex support is experimental and may require refinement based on user feedback. If you encounter issues, please report them on GitHub.

3.3 KiB Raw Blame History