🧬 Plexus

A high-performance, terminal-based task runner and process manager built for speed.

Plexus is a developer-centric tool designed to orchestrate complex task workflows with a modern Terminal User Interface (TUI). Whether you're managing microservices, long-running build pipelines, or complex monorepos, Plexus provides the observability and control you need directly in your terminal.

✨ Features

• Native Performance: Built with Rust for near-zero overhead and memory safety.
• Modern TUI: Interactive interface powered by ratatui for real-time process monitoring.
• Cross-Platform: Native binaries distributed via npm for Linux (x64/ARM), macOS, and Windows.
• Developer-First: Designed to work seamlessly in pnpm monorepos and advanced development environments.

🚀 Quick Start

You can run Plexus immediately without a permanent installation using npx:

npx @m.hesari/plexus

Installation

Install it globally via your preferred package manager:

# Using pnpm (Recommended)
pnpm add -g @m.hesari/plexus

# Using npm
npm install -g @m.hesari/plexus

🛠 Configuration

Plexus looks for a configuration file in your project root (e.g., plexus.json).

{
  "tasks": {
    "dev": "pnpm run dev",
    "build": "cargo build --release",
    "test": "npm test"
  }
}

📦 Architecture

Plexus uses a hybrid distribution model:

1. Core: High-performance Rust binaries tailored for specific CPU architectures.
2. Wrapper: A lightweight Node.js loader that detects your system profile (OS/Arch) and executes the correct native binary.

🏗 Development

If you want to build Plexus from source:

1. Clone the repo:

   git clone [https://github.com/mohamad-hesari/plexus.git](https://github.com/mohamad-hesari/plexus.git)

2. Build the Rust core:

   cargo build --release

3. Run the binary:

   ./target/release/plexus

📄 License

Distributed under the MIT License. See LICENSE for more information.