@r5n/hydra 0.4.0 → 0.5.1

package/README.md

@@ -3,8 +3,10 @@
     <img src="https://avatars.githubusercontent.com/u/99986752?s=400&v=4" alt="R5N Labs" width="100" height="100">
   </a>
 
+  <p><strong>The GitHub Runner Manager That Actually Scales 🚀</strong></p>
+  <p><em>🏊 Made for developers who'd rather be coding than configuring</em></p>
+  
   <h1>Hydra</h1>
-  <p><strong>GitHub Self-Hosted Runner Manager</strong></p>
 
   <p>
     <a href="https://www.npmjs.com/package/@r5n/hydra">
@@ -21,15 +23,77 @@
 
 ## Overview
 
-Hydra is a powerful CLI tool for managing multiple GitHub self-hosted runners locally. Built by [R5N Labs](https://github.com/r5n-labs), it simplifies the creation, management, and monitoring of GitHub Actions runners at scale.
+Tired of manually setting up GitHub Actions runners? Hydra transforms hours of tedious work into a single command. Create, manage, and monitor dozens of self-hosted runners with the simplicity you've been craving.
 
-### ✨ Key Features
+### ✨ Why Hydra?
 
-- 🚀 **Parallel Runner Management** - Create and manage multiple runners simultaneously using Web Workers
-- 🔧 **Profile-Based Configuration** - Store and reuse configurations with JSON/TOML support
-- 📊 **Real-Time Status Monitoring** - Check runner status with formatted or JSON output
-- 🏃 **Zero Runtime Dependencies** - Fully bundled (~73KB) for optimal performance
-- 🎯 **Cross-Platform Support** - Works on macOS, Linux, and Windows
+- 🚀 **Lightning Fast** - Create 20 runners in the time it takes to manually create 1
+- 🔧 **Smart Profiles** - Define once, deploy anywhere with reusable configs
+- 📊 **Live Insights** - See exactly what your runners are doing in real-time
+- 🏃 **73KB of Pure Speed** - Installs before your coffee finishes brewing
+- 🎯 **Works Everywhere** - macOS, Linux, Windows - we've got you covered
+
+## 🎯 What Can You Do?
+
+<details>
+<summary><strong>Create a fleet of runners in seconds</strong></summary>
+
+```bash
+$ hydra create -t $TOKEN -u https://github.com/myorg/repo -m 10 -l "gpu,docker"
+⠋ Downloading runner package... (2.1s)
+✔ Created runner gpu-runner-1
+✔ Created runner gpu-runner-2
+✔ Created runner gpu-runner-3
+✔ Created runner gpu-runner-4
+✔ Created runner gpu-runner-5
+✔ Created runner gpu-runner-6
+✔ Created runner gpu-runner-7
+✔ Created runner gpu-runner-8
+✔ Created runner gpu-runner-9
+✔ Created runner gpu-runner-10
+✅ All 10 runners created successfully in 8.3s
+```
+</details>
+
+<details>
+<summary><strong>Monitor your runner army</strong></summary>
+
+```bash
+$ hydra status -p production
+┌─────────────────┬─────────┬───────────┬──────────────┐
+│ Name            │ Status  │ Busy      │ Labels       │
+├─────────────────┼─────────┼───────────┼──────────────┤
+│ prod-runner-1   │ ✅ Idle │ No        │ linux,docker │
+│ prod-runner-2   │ ✅ Idle │ No        │ linux,docker │
+│ prod-runner-3   │ 🔄 Busy │ Yes (2m)  │ linux,docker │
+│ prod-runner-4   │ ✅ Idle │ No        │ linux,docker │
+│ prod-runner-5   │ ❌ Offline │ -      │ linux,docker │
+└─────────────────┴─────────┴───────────┴──────────────┘
+Summary: 3 idle, 1 busy, 1 offline
+```
+</details>
+
+<details>
+<summary><strong>Auto-scale based on workload</strong></summary>
+
+```bash
+$ hydra scale -p production --watch --max 10
+🚀 Starting auto-scaling for profile: production
+Configuration:
+  • Min runners: 2
+  • Max runners: 10  
+  • Scale up threshold: 3 pending jobs
+  • Scale down after: 10 minutes idle
+
+🔍 Monitoring runner status...
+⚡ Scaling event: 5 jobs pending, current runners: 3
+   → Scaling up by 2 runners
+   ✓ Created runner-4
+   ✓ Created runner-5
+
+🔍 Monitoring continues... (press Ctrl+C to stop)
+```
+</details>
 
 ## 📦 Installation
 
@@ -147,9 +211,9 @@ hydra create --help
 
 ## 🔧 Configuration
 
-### Profile System
+### The Magic of Profiles 🎭
 
-Hydra supports configuration profiles to simplify runner management across different environments.
+Stop typing the same commands over and over. Profiles let you define your runner configurations once and reuse them everywhere:
 
 #### Example: `hydra.json`
 
@@ -304,7 +368,3 @@ Contributions are welcome! Please see the [main repository](https://github.com/r
 Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for details.
 
 ---
-
-<div align="center">
-  Built with ❤️ by <a href="https://github.com/r5n-labs">R5N Labs</a>
-</div>