🚧 Work in progress: preparing SuperCodex v4.0.0

SuperCodex v4.0.0 🚀

SuperCodex is a meta-programming configuration framework that enhances Codex CLI with structured development capabilities. It provides 18 Markdown-based slash prompts, 13 specialized AI agents with Persona Mode, behavioral instructions, and workflow automation for systematic software development.

Quick Start

Installation Methods

Recommended: pipx (Isolated CLI Tool)

# Install with pipx for clean, isolated environment
pipx install SuperCodex

# Setup SuperCodex for Codex CLI (Choose one)
SuperCodex install --yes                    # Express setup (recommended)
SuperCodex install --profile minimal --yes  # Fastest (core only)
SuperCodex install --profile full --yes     # All features

Alternative: pip (Traditional Installation)

# Install with pip (may cause dependency conflicts)
pip install SuperCodex

# Or in a virtual environment (recommended if using pip)
python -m venv supercodex-env
source supercodex-env/bin/activate  # Linux/Mac
# or: supercodex-env\Scripts\activate  # Windows
pip install SuperCodex

Usage with Codex CLI

# Example commands after installation:
/sg:analyze src/
/sg:implement user authentication

Why pipx? SuperCodex is a standalone CLI tool. Using pipx:

• Prevents dependency conflicts with your projects
• Provides clean uninstallation
• Automatically manages virtual environments
• Keeps your system Python clean

Note for pipx users: If you encounter Node.js/npm detection issues during MCP setup, ensure these tools are available in your system PATH.

What is SuperCodex? 💎

SuperCodex transforms Codex CLI into a structured development platform by providing:

• 18 Slash Prompts: Markdown prompts for systematic workflow automation (/sg:analyze, /sg:implement, etc.)
• Persona Mode: 13 specialized AI agents that embody specific roles (system-architect, security-engineer, etc.)
• Behavioral Instructions: Core principles and rules for consistent development practices
• Workflow Automation: Systematic approaches to analysis, implementation, and optimization

Unlike traditional tools, SuperCodex uses Persona Mode where Codex CLI embodies agent roles rather than spawning separate sub-agents.

Documentation

Getting Started

• Quick Start Guide
• Installation Guide

User Guides

• Prompts Reference - 18 Markdown-based slash prompts
• Agents Guide - 13 specialized AI personas
• Behavioral Modes - Context-aware operation modes
• Flags Guide - Command flags and options
• MCP Servers - MCP server integration guide
• Session Management - Session lifecycle management

Developer Resources

• Technical Architecture
• Contributing Code
• Testing & Debugging

Reference

• Quick Start Practices
• Examples Cookbook
• Troubleshooting

Contributing

Current Priorities:

• 📝 Documentation improvements and usage examples
• 🎯 Prompt workflow patterns and best practices
• 🤖 New AI agent personas for specialized domains
• 🧪 Testing and validation for Codex CLI integration
• 🌐 Translation and internationalization

See CONTRIBUTING.md for detailed contribution guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributors: View all contributors