Language	Python
Stars	2
Forks	0
Last Updated	2/18/2026

Sentinel

A lightweight process supervisor CLI for managing background processes with ease.

Features

Start & manage processes: Run background processes with automatic logging
Process monitoring: Real-time CPU, memory, and uptime tracking
Auto-restart: Optional automatic restart on process exit
Port management: Check and manage port usage
Rich output: Beautiful formatted tables and logs with rich CLI
Persistent state: Track processes across sessions

Installation

It's recommended to use the uv package manager for python:

1uv tool install git+https://github.com/4ster-light/sentinel

But you can also do it with pip as follows:

1pip install git+https://github.com/4ster-light/sentinel

Quick Start

Run a process

1
2
3
4
5# Start a background process
sentinel run "python server.py" --name myserver

# Start with auto-restart enabled
sentinel run "npm start" --name frontend --restart

List processes

1
2# View all managed processes with status
sentinel list

Control processes

1
2
3
4
5
6
7
8# Stop a process by ID or name
sentinel stop myserver

# Force kill a process
sentinel stop myserver --force

# Restart a process
sentinel restart myserver

View logs

1
2
3
4
5# Show process logs
sentinel logs myserver

# Clear logs
sentinel logs myserver --clear

Port management

1
2
3
4
5
6
7
8# Allocate a port
sentinel port allocate

# List allocated ports
sentinel port list

# Free an allocated port
sentinel port free 8000

Usage

1sentinel --help

For detailed help on any command:

1sentinel <command> --help

License

MIT

Repository Information