Run Nest 🚀

Cross-Platform Script Automation & Execution Manager
Developed by AFNAN with ❤️ • github.com/afnan-nex

---

Overview

Run Nest is a powerful, modern desktop application engineered for running, scheduling, sequencing, and monitoring automation scripts with enterprise-grade reliability. Built with Electron, Material Design 3, and SQLite, Run Nest handles everything from simple shell tasks to mission-critical, high-frequency workflows.

---

✨ Features

• Multi-Runtime Script Execution:

  • Native support for Python, Node.js, PowerShell, Bash, Batch, and compiled Executables.
  • Auto-detection of local system runtimes and missing Python dependencies with install recommendations.
  • Script elevation via native Windows UAC (runas) and Linux Polkit (pkexec/sudo).

• Flexible Scheduling Engine:

  • Equal interval execution within custom daytime/nighttime windows.
  • Random-gap execution with minimum interval enforcement.
  • Specific target clock times (e.g. 09:00, 14:30, 21:00).
  • 24-hour visual schedule timeline and real-time execution quota tracking (Runs Today, Max Runs, Remaining).
  • Missed schedule detection and recovery on system restart.

• Workflow Sequences:

  • Chain scripts into multi-step automated pipelines.
  • Configurable failure policies: Stop, Continue, or Retry with backoff.
  • Step delays, timeout enforcement, and dry-run execution simulations.

• Repetition & Concurrency Control:

  • Repeat execution support with configurable inter-run delays and retry strategies.
  • Multi-instance concurrency prevention or numbered parallel executions (allow_multiple).

• Live Streaming & Real-Time Monitoring:

  • Live terminal output streaming with color-coded stdout/stderr.
  • Searchable execution history with exit codes, durations, and memory/CPU metrics.
  • System logs export with native OS save file dialogs.

• Automated Backups & Data Portability:

  • Export full backup archives (.zip) containing database, scripts, and logs.
  • Export and import configuration JSON files.
  • Auto-backup on startup and schedule recovery.

• Modern Material 3 Interface:

  • Light and Dark modes with real-time theme switching.
  • Collapsible navigation rail with quick-expand triggers.
  • Built-in CodeMirror editor for inline script viewing and editing.

---

📥 Download & Installation

Head over to the Releases Page to download the latest build:

🪟 Windows

Package	Description
Run Nest Setup 1.0.1.exe	Windows Setup Wizard (Desktop shortcut, Start Menu shortcut, Uninstaller)
Run Nest 1.0.1.exe	Standalone Portable executable (Runs anywhere, no installation required)

🐧 Linux

Package	Description
run-nest-1.0.1.tar.gz	Universal Linux archive (Runs on all distros: Ubuntu, Debian, Fedora, Arch, etc.)
run-nest-1.0.1.zip	Universal Linux portable zip archive

---

🛠️ Development Setup

Prerequisites

• Node.js (v18 or higher recommended)
• Git

Clone and Install

git clone https://github.com/afnan-nex/Run-Nest.git
cd Run-Nest
npm install

Run in Development

npm start

Run Tests

npm test

Build Windows Installers

npm run package:win

The compiled setup wizard and portable executable will be placed in dist/.

---

📂 Project Structure

Run-Nest/
├── assets/                  # Application icons, SVGs, and bundled CodeMirror assets
├── migrations/              # SQLite database schema migrations
├── src/
│   ├── main/                # Electron main process
│   │   ├── database/        # SQLite DatabaseManager & schema initialization
│   │   ├── process-manager/ # Process execution, repetition & elevation engine
│   │   ├── scheduler/       # Cron & precision interval scheduling engine
│   │   ├── sequence/        # Multi-step sequential pipeline engine
│   │   ├── platform/        # OS-specific handlers (Windows & Linux)
│   │   ├── updater/         # GitHub Releases update checker
│   │   └── backups/         # Database and script backup manager
│   ├── preload/             # Secure contextBridge IPC preload script
│   └── renderer/            # Material 3 UI pages, components, and styling
├── tests/
│   ├── unit/                # Unit test suites for core managers
│   └── integration/         # End-to-end integration and flow tests
├── electron-builder.yml     # Multi-platform distribution configuration
└── package.json

---

📄 License

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

---

👨‍💻 Author

Developed with ❤️ by AFNAN
GitHub: @afnan-nex