awesome-slash 2.4.2

package/adapters/opencode/README.md

@@ -0,0 +1,301 @@
+# awesome-slash for OpenCode
+
+Professional-grade slash commands adapted for OpenCode.
+
+## Quick Install
+
+```bash
+git clone https://github.com/avifenesh/awesome-slash.git
+cd awesome-slash
+./adapters/opencode/install.sh
+```
+
+## Prerequisites
+
+- **OpenCode** - Install from [opencode.ai](https://opencode.ai)
+- **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
+opencode
+> /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
+opencode
+> /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
+opencode
+> /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
+opencode
+> /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`)
+
+---
+
+
+## OpenCode-Specific Features
+
+OpenCode provides additional features you can combine with awesome-slash commands:
+
+### File Includes with `@`
+
+Include file contents in your prompt:
+
+```bash
+opencode
+> /project-review @src/main.py @tests/test_main.py
+```
+
+This adds the file contents to the context before running the review.
+
+### Bash Output with `!`
+
+Include bash command output:
+
+```bash
+opencode
+> /deslop-around apply !git diff --name-only
+```
+
+This runs `git diff --name-only` and includes the output in the prompt.
+
+### Combined Usage
+
+```bash
+opencode
+> /next-task @PLAN.md !gh issue list
+```
+
+Analyzes tasks with PLAN.md content and current GitHub issues.
+
+---
+
+## Installation Details
+
+The installer:
+1. Creates `~/.opencode/commands/awesome-slash/`
+2. Copies command files with path adjustments
+3. Installs shared libraries (platform detection, patterns)
+4. Creates environment setup scripts
+
+### File Structure
+
+```
+~/.opencode/commands/awesome-slash/
+├── 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 with file filter
+```bash
+opencode
+> /deslop-around apply @src/app.js
+
+# Changeset 1/3: Remove console.log statements
+# - src/app.js: Removed 3 console.log calls
+# ✓ Tests passed
+```
+
+### Review specific files
+```bash
+opencode
+> /project-review @src/auth.py @src/api.py
+
+# Iteration 1: Found 4 issues (2 critical, 2 high)
+# ✓ Fixed SQL injection in auth.py:45
+# ✓ Fixed race condition in api.py:123
+```
+
+### Next task with context
+```bash
+opencode
+> /next-task @PLAN.md !gh issue list
+
+# Top 5 Priority Tasks:
+# (includes analysis from PLAN.md and GitHub issues)
+```
+
+### Ship with diff review
+```bash
+opencode
+> !git diff
+> /ship --strategy rebase
+
+# (reviews the diff you just displayed, then ships)
+```
+
+---
+
+## 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/opencode/install.sh
+```
+
+---
+
+## Troubleshooting
+
+### Commands not showing up
+1. Restart OpenCode TUI
+2. Check installation: `ls ~/.opencode/commands/awesome-slash/`
+3. Re-run installer
+
+### Commands only work in TUI
+
+Currently, OpenCode slash commands are only available in the TUI (Terminal User Interface), not from the CLI directly. Feature request exists to add CLI support.
+
+### Path errors
+Re-run installer to fix path substitutions:
+```bash
+./adapters/opencode/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
+```
+
+---
+
+## Differences from Claude Code
+
+| Feature | Claude Code | OpenCode |
+|---------|-------------|----------|
+| Installation | Marketplace | Manual script |
+| Updates | Automatic | Re-run installer |
+| File Includes | Built-in | `@filename` syntax |
+| Bash Output | Built-in | `!command` syntax |
+| Multi-agent | Full support | May vary |
+
+---
+
+## Support
+
+- **Repository**: https://github.com/avifenesh/awesome-slash
+- **Issues**: https://github.com/avifenesh/awesome-slash/issues
+- **OpenCode Docs**: https://opencode.ai/docs
+
+---
+
+## Resources
+
+- [OpenCode Commands](https://opencode.ai/docs/commands/)
+- [OpenCode CLI](https://opencode.ai/docs/cli/)
+- [awesome-slash Main README](../../README.md)
+- [Multi-Tool Adapters](../README.md)
+
+---
+
+Made with ❤️ for the OpenCode community

package/adapters/opencode/install.sh

@@ -0,0 +1,223 @@
+#!/usr/bin/env bash
+set -e
+
+# OpenCode Installer for awesome-slash commands
+# This script installs all 5 slash commands for use with OpenCode
+
+echo "🚀 Installing awesome-slash commands for OpenCode..."
+echo
+
+# Configuration
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+OPENCODE_CONFIG_DIR="${HOME}/.opencode"
+OPENCODE_COMMANDS_DIR="${OPENCODE_CONFIG_DIR}/commands/awesome-slash"
+LIB_DIR="${OPENCODE_COMMANDS_DIR}/lib"
+
+# Detect OS and normalize paths
+if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+  IS_WINDOWS=true
+  # Convert Windows path to Unix-style for bash compatibility
+  OPENCODE_CONFIG_DIR="${USERPROFILE}/.opencode"
+  # Replace backslashes with forward slashes
+  OPENCODE_CONFIG_DIR="${OPENCODE_CONFIG_DIR//\\//}"
+  OPENCODE_COMMANDS_DIR="${OPENCODE_CONFIG_DIR}/commands/awesome-slash"
+  LIB_DIR="${OPENCODE_COMMANDS_DIR}/lib"
+else
+  IS_WINDOWS=false
+fi
+
+echo "📂 Configuration:"
+echo "  Repository: $REPO_ROOT"
+echo "  Install to: $OPENCODE_COMMANDS_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 OpenCode (optional - user may not have it installed yet)
+if command -v opencode &> /dev/null; then
+  OPENCODE_VERSION=$(opencode --version 2>&1 | head -n1 || echo "unknown")
+  echo "  ✓ OpenCode $OPENCODE_VERSION"
+else
+  echo "  ⚠️  OpenCode not found (install from: https://opencode.ai)"
+  echo "     You can still install commands and use OpenCode later"
+fi
+
+echo
+
+# Create directories
+echo "📁 Creating directories..."
+mkdir -p "$OPENCODE_COMMANDS_DIR"
+mkdir -p "$LIB_DIR"/{platform,patterns,utils}
+echo "  ✓ Created $OPENCODE_COMMANDS_DIR"
+echo "  ✓ Created $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" "${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"
+  TARGET_FILE="$OPENCODE_COMMANDS_DIR/$cmd.md"
+
+  if [ -f "$SOURCE_FILE" ]; then
+    # Replace Claude-specific path variables with OpenCode paths
+    # Escape sed special characters in path to prevent injection
+    SAFE_COMMANDS_DIR=$(echo "${OPENCODE_COMMANDS_DIR}" | sed 's/[&/\]/\\&/g')
+    sed "s|\${CLAUDE_PLUGIN_ROOT}|${SAFE_COMMANDS_DIR}|g" "$SOURCE_FILE" > "$TARGET_FILE"
+    echo "  ✓ Installed /$cmd"
+  else
+    echo "  ⚠️  Skipped /$cmd (source not found)"
+  fi
+done
+
+echo
+
+# Create environment setup script
+echo "📝 Creating environment setup..."
+cat > "$OPENCODE_COMMANDS_DIR/env.sh" << 'EOF'
+#!/usr/bin/env bash
+# Environment variables for awesome-slash commands in OpenCode
+
+# Set the root directory for commands to find libraries
+export OPENCODE_COMMANDS_ROOT="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+# Add lib directory to NODE_PATH if needed
+export NODE_PATH="${OPENCODE_COMMANDS_ROOT}/lib:${NODE_PATH}"
+
+# Platform detection helpers
+export AWESOME_SLASH_PLATFORM_SCRIPT="${OPENCODE_COMMANDS_ROOT}/lib/platform/detect-platform.js"
+export AWESOME_SLASH_TOOLS_SCRIPT="${OPENCODE_COMMANDS_ROOT}/lib/platform/verify-tools.js"
+EOF
+
+chmod +x "$OPENCODE_COMMANDS_DIR/env.sh"
+echo "  ✓ Created environment setup script"
+echo
+
+# Create README
+cat > "$OPENCODE_COMMANDS_DIR/README.md" << 'EOF'
+# awesome-slash for OpenCode
+
+This directory contains the awesome-slash commands adapted for OpenCode.
+
+## Available Commands
+
+- `/deslop-around` - AI slop cleanup with minimal diffs
+- `/next-task` - Intelligent task prioritization
+- `/project-review` - Multi-agent code review
+- `/ship` - Complete PR workflow
+- `/pr-merge` - Intelligent PR merge
+
+## Usage
+
+In OpenCode TUI, invoke commands directly:
+
+```bash
+/deslop-around
+/next-task
+/project-review
+/ship
+/pr-merge
+```
+
+You can also pass arguments:
+```bash
+/deslop-around apply
+/next-task bug
+/ship --strategy rebase
+```
+
+## OpenCode-Specific Features
+
+OpenCode supports additional features you can use with these commands:
+
+- **@filename** - Include file contents in prompt
+- **!command** - Include bash command output in prompt
+
+Example:
+```bash
+/project-review @src/main.py
+/deslop-around apply !git diff --name-only
+```
+
+## Environment
+
+Commands use the shared library at:
+```
+~/.opencode/commands/awesome-slash/lib/
+```
+
+## Updates
+
+To update commands, re-run the installer:
+```bash
+cd /path/to/awesome-slash
+./adapters/opencode/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:"
+for cmd in "${COMMANDS[@]}"; do
+  echo "  • /$cmd"
+done
+echo
+echo "📖 Next Steps:"
+echo "  1. Start OpenCode TUI: opencode"
+echo "  2. Use commands: /$cmd"
+echo "  3. See help: cat $OPENCODE_COMMANDS_DIR/README.md"
+echo
+echo "💡 OpenCode Pro Tips:"
+echo "  • Use @filename to include file contents"
+echo "  • Use !command to include bash output"
+echo "  • Example: /project-review @src/main.py"
+echo
+echo "🔄 To update commands, re-run this installer:"
+echo "  ./adapters/opencode/install.sh"
+echo
+echo "Happy coding! 🎉"