Pomitu

Pomitu is a simple process manager inspired by PM2

Installation

To install Pomitu globally, run:

npm install -g pomitu

Usage

Pomitu provides several commands to manage your applications:

Start an application

pomitu start <config-file>

This command starts and daemonizes an app based on the configuration file provided.

Interactive Mode (TUI)

pomitu start <config-file> --no-daemon

Run in interactive mode with a Terminal User Interface (TUI) that allows you to:

• View the status of all processes in real-time
• Start, stop, and restart individual apps
• Navigate with arrow keys
• Press q to quit

The interactive mode is perfect for development when you want to manage multiple processes and see their status at a glance.

Options

• --no-daemon - Run in interactive TUI mode instead of daemonizing
• --clear-logs - Clear log files before starting the app

Stop an application

pomitu stop <name>

This command stops a running app. Use pomitu stop all to stop all running apps.

Note: In interactive TUI mode (--no-daemon), you can stop apps directly from the interface instead of using this command.

List running applications

pomitu ls

This command lists all currently running applications managed by Pomitu.

Flush logs

pomitu flush [name]

This command flushes the logs for all apps or a specific app if a name is provided.

Configuration

Pomitu uses a YAML configuration file to define the applications you want to manage. Here's an example structure:

apps:
  - name: "App 1"
    cwd: "/path/to/app1"
    run: "npm start"
  - name: "App 2"
    cwd: "/path/to/app2"
    run: "node server.js"

Development

If you want to contribute to Pomitu or run it in development mode:

1. Clone the repository
2. Install dependencies:

   npm install

3. Run in development mode:

   npm run dev

Dev installation test:

npm run build && npm pack && npm install -g pomitu-1.6.0.tgz && rm pomitu-1.6.0.tgz

Linting

To lint the code:

npm run lint

To lint and auto-fix:

npm run lint-fix

Building

To build the project:

npm run build

To build and run:

npm start

License

ISC License