awesome-slash 2.4.2

package/adapters/codex/README.md

@@ -0,0 +1,272 @@
+# awesome-slash for Codex CLI
+
+Professional-grade slash commands adapted for OpenAI's Codex CLI.
+
+## Quick Install
+
+```bash
+git clone https://github.com/avifenesh/awesome-slash.git
+cd awesome-slash
+./adapters/codex/install.sh
+```
+
+## Prerequisites
+
+- **Codex CLI** - Install from [developers.openai.com/codex/cli](https://developers.openai.com/codex/cli)
+- **Node.js 18+** - Download from [nodejs.org](https://nodejs.org)
+- **Git** - Download from [git-scm.com](https://git-scm.com)
+- **GitHub CLI (`gh`)** - For PR commands (install: `brew install gh` or see [cli.github.com](https://cli.github.com))
+
+## Available Commands
+
+### 🧹 `/deslop-around` - AI Slop Cleanup
+
+Remove debugging code, old TODOs, and other AI slop.
+
+```bash
+codex
+> /deslop-around
+> /deslop-around apply
+> /deslop-around apply src/ 10
+```
+
+**What it does:**
+- Scans for console.logs, print statements, old TODOs
+- Generates report or auto-applies fixes
+- Runs verification tests
+- Preserves functionality with minimal diffs
+
+---
+
+### 📋 `/next-task` - Intelligent Task Prioritization
+
+Discover what to work on next with AI analysis.
+
+```bash
+codex
+> /next-task
+> /next-task bug
+> /next-task --include-blocked
+```
+
+**What it does:**
+- Analyzes GitHub Issues (required)
+- Validates tasks aren't already implemented
+- Scores by impact, urgency, effort
+- Provides top 5 recommendations with evidence
+
+**Requires:** GitHub CLI (`gh`)
+
+---
+
+### 🔍 `/project-review` - Multi-Agent Code Review
+
+Comprehensive review with specialized AI agents.
+
+```bash
+codex
+> /project-review
+> /project-review --recent
+> /project-review --domain security
+```
+
+**What it does:**
+- Deploys 8 specialized agents
+- Adapts to your tech stack
+- Finds bugs, security issues, performance problems
+- Iterates until zero critical issues
+
+---
+
+### 🚀 `/ship` - Complete PR Workflow
+
+Ship from commit to production with validation.
+
+```bash
+codex
+> /ship
+> /ship --strategy rebase
+```
+
+**What it does:**
+1. Commits changes with AI message
+2. Creates PR with description
+3. Waits for CI to pass
+4. Runs quality reviews
+5. Merges to main
+6. Deploys to dev/prod
+7. Validates deployments
+8. Auto-rollback on failure
+
+**Requires:** Git, GitHub CLI (`gh`)
+
+---
+
+## Installation Details
+
+The installer:
+1. Creates `~/.codex/prompts/awesome-slash/`
+2. Copies command files with path adjustments
+3. Installs shared libraries (platform detection, patterns)
+4. Creates environment setup scripts
+
+### File Structure
+
+```
+~/.codex/prompts/awesome-slash/
+├── commands/
+│   ├── deslop-around.md
+│   ├── next-task.md
+│   ├── project-review.md
+│   └── ship.md
+├── lib/
+│   ├── platform/
+│   │   ├── detect-platform.js
+│   │   └── verify-tools.js
+│   ├── patterns/
+│   │   ├── review-patterns.js
+│   │   └── slop-patterns.js
+│   └── utils/
+│       └── context-optimizer.js
+├── env.sh
+└── README.md
+```
+
+---
+
+## Usage Examples
+
+### Clean up debugging code
+```bash
+codex
+> /deslop-around apply
+
+# Changeset 1/5: Remove console.log statements
+# - src/app.js: Removed 3 console.log calls
+# ✓ Tests passed
+#
+# Summary: 5 files changed, 23 lines deleted
+```
+
+### Get next priority task
+```bash
+codex
+> /next-task
+
+# Top 5 Priority Tasks:
+#
+# 1. [High Impact] Fix login timeout on mobile
+#    Score: 9.2/10 (Impact: 10, Urgency: 9, Effort: 3)
+#    Status: not-started (no code found)
+```
+
+### Ship a feature
+```bash
+# Make your changes
+git add .
+
+codex
+> /ship
+
+# ✓ Commits with AI message
+# ✓ Creates PR with context
+# ✓ Waits for CI
+# ✓ Reviews code
+# ✓ Merges to main
+# ✓ Deploys and validates
+```
+
+---
+
+## Codex-Specific Notes
+
+### Custom Prompt Integration
+
+These commands integrate with Codex's custom prompt system. You can also create shortcuts by adding to your Codex config.
+
+### Multi-Agent Differences
+
+Codex CLI may handle multi-agent workflows differently than Claude Code. Commands will adapt to available capabilities.
+
+### Built-in Commands
+
+Use alongside Codex's built-in commands:
+- `/diff` - View Git diff
+- `/review` - Codex's native review
+- `/compact` - Summarize conversation
+- `/model` - Switch models
+
+awesome-slash commands complement these.
+
+---
+
+## Platform Support
+
+### Auto-Detected CI Platforms
+GitHub Actions · GitLab CI · CircleCI · Jenkins · Travis CI
+
+### Auto-Detected Deployment Platforms
+Railway · Vercel · Netlify · Fly.io · Platform.sh · Render
+
+### Auto-Detected Project Types
+Node.js · Python · Rust · Go · Java
+
+---
+
+## Updating
+
+To update commands:
+
+```bash
+cd /path/to/awesome-slash
+git pull origin main
+./adapters/codex/install.sh
+```
+
+---
+
+## Troubleshooting
+
+### Commands not showing up
+1. Restart Codex CLI
+2. Check installation: `ls ~/.codex/prompts/awesome-slash/commands/`
+3. Re-run installer
+
+### Path errors
+Re-run installer to fix path substitutions:
+```bash
+./adapters/codex/install.sh
+```
+
+### Node.js not found
+Ensure Node.js 18+ is installed:
+```bash
+node --version  # Should be v18.0.0 or higher
+```
+
+### GitHub CLI authentication
+```bash
+gh auth login
+gh auth status
+```
+
+---
+
+## Support
+
+- **Repository**: https://github.com/avifenesh/awesome-slash
+- **Issues**: https://github.com/avifenesh/awesome-slash/issues
+- **Codex CLI Docs**: https://developers.openai.com/codex/cli
+
+---
+
+## Resources
+
+- [Codex CLI Slash Commands](https://developers.openai.com/codex/cli/slash-commands/)
+- [Custom Prompts](https://developers.openai.com/codex/custom-prompts/)
+- [awesome-slash Main README](../../README.md)
+- [Multi-Tool Adapters](../README.md)
+
+---
+
+Made with ❤️ for the Codex CLI community

package/adapters/codex/install.sh

@@ -0,0 +1,179 @@
+#!/usr/bin/env bash
+set -e
+
+# Codex CLI Installer for awesome-slash commands
+# This script installs all 5 slash commands for use with OpenAI Codex CLI
+
+echo "🚀 Installing awesome-slash commands for Codex CLI..."
+echo
+
+# Configuration
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+CODEX_CONFIG_DIR="${HOME}/.codex"
+CODEX_PROMPTS_DIR="${CODEX_CONFIG_DIR}/prompts"
+CODEX_LIB_DIR="${CODEX_CONFIG_DIR}/awesome-slash/lib"
+
+# Detect OS and normalize paths
+if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+  IS_WINDOWS=true
+  # Convert Windows path to Unix-style for bash compatibility
+  CODEX_CONFIG_DIR="${USERPROFILE}/.codex"
+  # Replace backslashes with forward slashes
+  CODEX_CONFIG_DIR="${CODEX_CONFIG_DIR//\\//}"
+  CODEX_PROMPTS_DIR="${CODEX_CONFIG_DIR}/prompts"
+  CODEX_LIB_DIR="${CODEX_CONFIG_DIR}/awesome-slash/lib"
+else
+  IS_WINDOWS=false
+fi
+
+echo "📂 Configuration:"
+echo "  Repository: $REPO_ROOT"
+echo "  Prompts to: $CODEX_PROMPTS_DIR"
+echo "  Libraries to: $CODEX_LIB_DIR"
+echo
+
+# Check prerequisites
+echo "🔍 Checking prerequisites..."
+
+# Check Node.js
+if ! command -v node &> /dev/null; then
+  echo "❌ Node.js not found. Install from: https://nodejs.org"
+  exit 1
+fi
+NODE_VERSION=$(node --version)
+echo "  ✓ Node.js $NODE_VERSION"
+
+# Check Git
+if ! command -v git &> /dev/null; then
+  echo "❌ Git not found. Install from: https://git-scm.com"
+  exit 1
+fi
+GIT_VERSION=$(git --version | cut -d' ' -f3)
+echo "  ✓ Git $GIT_VERSION"
+
+# Check Codex CLI (optional - user may not have it installed yet)
+if command -v codex &> /dev/null; then
+  CODEX_VERSION=$(codex --version 2>&1 | head -n1 || echo "unknown")
+  echo "  ✓ Codex CLI $CODEX_VERSION"
+else
+  echo "  ⚠️  Codex CLI not found (install from: https://developers.openai.com/codex/cli)"
+  echo "     You can still install commands and use Codex CLI later"
+fi
+
+echo
+
+# Create directories
+echo "📁 Creating directories..."
+mkdir -p "$CODEX_PROMPTS_DIR"
+mkdir -p "$CODEX_LIB_DIR"/{platform,patterns,utils}
+echo "  ✓ Created $CODEX_PROMPTS_DIR"
+echo "  ✓ Created $CODEX_LIB_DIR"
+echo
+
+# Copy library files from shared root lib directory
+echo "📚 Installing shared libraries..."
+# Use explicit iteration to handle paths with spaces safely
+for item in "${REPO_ROOT}/lib"/*; do
+  cp -r "$item" "${CODEX_LIB_DIR}/"
+done
+echo "  ✓ Copied platform detection"
+echo "  ✓ Copied pattern libraries"
+echo "  ✓ Copied utility functions"
+echo
+
+# Install commands with path adjustments
+echo "⚙️  Installing commands..."
+
+COMMANDS=(
+  "deslop-around"
+  "next-task"
+  "project-review"
+  "ship"
+  "pr-merge"
+)
+
+for cmd in "${COMMANDS[@]}"; do
+  SOURCE_FILE="$REPO_ROOT/plugins/$cmd/commands/$cmd.md"
+  # Install directly in prompts directory (Codex looks here)
+  TARGET_FILE="$CODEX_PROMPTS_DIR/$cmd.md"
+
+  if [ -f "$SOURCE_FILE" ]; then
+    # Replace Claude-specific path variables with Codex lib paths
+    # Escape sed special characters in path to prevent injection
+    SAFE_LIB_DIR=$(echo "${CODEX_LIB_DIR}/.." | sed 's/[&/\]/\\&/g')
+    sed "s|\${CLAUDE_PLUGIN_ROOT}|${SAFE_LIB_DIR}|g" "$SOURCE_FILE" > "$TARGET_FILE"
+    echo "  ✓ Installed /prompts:$cmd"
+  else
+    echo "  ⚠️  Skipped /$cmd (source not found)"
+  fi
+done
+
+echo
+
+# Create README
+cat > "$CODEX_CONFIG_DIR/AWESOME_SLASH_README.md" << 'EOF'
+# awesome-slash for Codex CLI
+
+Commands installed for OpenAI Codex CLI.
+
+## Available Commands
+
+Access via /prompts: menu:
+- `/prompts:deslop-around` - AI slop cleanup
+- `/prompts:next-task` - Task prioritization
+- `/prompts:project-review` - Code review
+- `/prompts:ship` - PR workflow
+- `/prompts:pr-merge` - PR merge
+
+## Usage
+
+In Codex CLI:
+```bash
+codex
+> /prompts:deslop-around
+> /prompts:next-task bug
+> /prompts:ship --strategy rebase
+```
+
+Or type `/prompts:` to see the menu.
+
+## Libraries
+
+Shared libraries at: ~/.codex/awesome-slash/lib/
+
+## Updates
+
+```bash
+cd /path/to/awesome-slash
+./adapters/codex/install.sh
+```
+
+## Support
+
+- Repository: https://github.com/avifenesh/awesome-slash
+- Issues: https://github.com/avifenesh/awesome-slash/issues
+EOF
+
+echo "  ✓ Created README"
+echo
+
+# Success message
+echo "✅ Installation complete!"
+echo
+echo "📋 Installed Commands (access via /prompts: menu):"
+for cmd in "${COMMANDS[@]}"; do
+  echo "  • /prompts:$cmd"
+done
+echo
+echo "📖 Next Steps:"
+echo "  1. Start Codex CLI: codex"
+echo "  2. Type: /prompts: (shows menu)"
+echo "  3. Select a command or type: /prompts:deslop-around"
+echo "  4. See help: cat $CODEX_CONFIG_DIR/AWESOME_SLASH_README.md"
+echo
+echo "💡 Pro Tip: Type /prompts: to see all available prompts"
+echo
+echo "🔄 To update commands, re-run this installer:"
+echo "  ./adapters/codex/install.sh"
+echo
+echo "Happy coding! 🎉"