DarthSim/overmind
Overmind
Overmind is a process manager for starting and monitoring multiple background processes defined in a Procfile. It functions as an interactive process controller that allows users to attach terminals to running processes for direct input and control.
The project differentiates itself through its integration with a terminal multiplexer to organize process outputs into separate windows and its ability to act as a remote process manager via a network-capable controller. It supports a daemonized execution mode to maintain process execution in the background while providing separate interfaces for logs and termination.
The system covers multi-process stack management, including process instance scaling and resilience configuration for automatic restarts. It manages environment variables through multiple configuration files and provides dynamic port allocation for interdependent services. Operational capabilities include targeted process restarts and termination without interrupting the wider operational stack.
Features
- Procfile-Based Runners - Starts and manages all processes defined in a Procfile simultaneously for local development.
- Daemonized Process Execution - Provides a background daemon mode to maintain process execution while offering separate interfaces for logs and termination.
- Procfile-Based Managers - Runs and monitors multiple application processes defined in a Procfile for simplified local development.
- Process Window Isolation - Integrates with Tmux to isolate process outputs into separate windows for organized real-time monitoring.
- Multiplexer-Based Orchestrators - Organizes multiple process outputs into separate Tmux windows for real-time monitoring and control.
- Local Infrastructure Orchestration - Orchestrates the starting and restarting of interdependent services for local development environments.
- Interactive Process Redirection - Allows users to attach interactive terminals to running background processes for direct input and control.
- Process Managers - Starts and monitors a full stack of background processes from a configuration file within a single session.
- Process Supervision - Implements active fault-tolerance by monitoring background tasks and automatically restarting failed components.
- Targeted Process Termination - Provides the ability to terminate a specific designated process while maintaining the execution of all other managed processes.
- tmux Session Managers - Automates the organization of Tmux windows and panes to manage a stack of background services.
- Environment Variable Management - Injects and manages host-level environment variables from multiple files for runtime configuration.
- Supervised Process Restarts - Implements automatic restarts of child processes based on failure or exit status using a supervision model.
- Selective Service Restarts - Allows rebooting a single process or a specific group of services without interrupting the wider operational stack.
- Automatic Port Allocation - Dynamically assigns available network ports to services based on a base port and incremental step to avoid conflicts.
- Scoped Environment Variable Injections - Loads project-specific environment variables from .env files with support for scoping and overrides.
- Remote Process Management - Allows for the inspection and control of active processes running on remote hosts via a network interface.
- TCP Management Interfaces - Provides a network-capable controller that binds to a TCP socket for remote process execution and monitoring.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
