PlexrPlan + Executor

🎉 Latest Release: v0.1.0 ​

Download the latest release from GitHub Releases or install with:

go install github.com/SphereStacking/plexr/cmd/plexr@v0.1.0

Quick Start ​

Install Plexr and get started in minutes:

# Install latest release
go install github.com/SphereStacking/plexr/cmd/plexr@latest

# Or download pre-built binary
curl -sSL https://github.com/SphereStacking/plexr/releases/latest/download/plexr_$(uname -s)_$(uname -m | sed 's/x86_64/x86_64/;s/aarch64/arm64/').tar.gz | tar xz
sudo mv plexr /usr/local/bin/

# Run your first plan
plexr execute setup.yml

Why Plexr? ​

The Problem ​

• 😫 "I followed the README but it doesn't work"
• ⏰ "Setting up the dev environment took all day"
• 🤷 "It works on my machine"
• 🔧 "Everyone's environment is slightly different"

The Solution ​

Plexr makes environment setup:

• Reproducible: Same result every time
• Debuggable: Clear error messages with solutions
• Maintainable: Version controlled setup procedures
• Team-friendly: Everyone uses the same configuration

Example Configuration ​

name: "My Project Setup"
version: "1.0.0"

steps:
  - id: install_deps
    description: "Install dependencies"
    executor: shell
    files:
      - path: "scripts/install.sh"
        platform: linux
      - path: "scripts/install.ps1"
        platform: windows

  - id: setup_database
    description: "Initialize database"
    executor: shell
    depends_on: [install_deps]
    files:
      - path: "scripts/db_setup.sh"

Features ​

v0.1.0 (Current Release) ​

• ✅ Core execution engine with dependency resolution
• ✅ Shell executor for running scripts and commands
• ✅ SQL executor with PostgreSQL support
• ✅ State management with resume capability
• ✅ CLI commands (execute, validate, status, reset)
• ✅ Environment variable expansion
• ✅ Platform-specific file selection
• ✅ Error handling and rollback support

Coming Soon ​

• 🚧 Additional database support (MySQL, SQLite)
• 🚧 HTTP executor for API calls
• 🚧 Docker executor
• 🚧 Parallel execution
• 🚧 Advanced conditional logic

Learn More ​

• Installation Guide - Get Plexr installed on your system
• Configuration Reference - Learn about YAML configuration
• Examples - See real-world usage patterns
• API Documentation - Detailed technical reference