🧬 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"
  }
}

🖱 Mouse scrolling in the TUI

Mouse capture is off by default, so your terminal keeps its own click-drag text selection. Start with --mouse, or press m while the TUI is running, to let the wheel scroll the log. The status bar shows Wheel on or Wheel off so you can tell which mode you are in.

Inside tmux you need both halves, because tmux does not forward mouse events to a pane unless you have asked it to:

set -g mouse on

Without that, tmux never asks the terminal for mouse events and nothing reaches Plexus, no matter which flags you pass. j/k, PgUp/PgDn and Home/End always work regardless.

📦 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.