#daemon #task-manager

app eggsecutor

A simple and lightweight stateful daemon tracking CLI

4 stable releases

2.0.0 May 2, 2022
1.2.0 May 2, 2022
1.1.0 Nov 25, 2021
1.0.0 Nov 15, 2021

#2090 in Command line utilities

28 downloads per month


738 lines

🍳eggsecutor 🥚

A friendly file based stateful daemon tracker.

Table of contents


  • Install from crates.io

    • cargo install eggsecutor
  • Build manually from source

    $ git clone https://github.com/astherath/eggsecutor
    $ cd eggsecutor
    $ cargo install --path=.


eggsecutor works best when launching single-file binaries that are meant to run as background processes.

eggsecutor 1.0

astherath <me@felipearce.dev>

A friendly background process task manager

    eggsecutor [SUBCOMMAND]

    -h, --help       Print help information
    -V, --version    Print version information

    clear    stops all of the processes being tracked and clears the tracking list
    hatch    start managing a binary process
    help     Print this message or the help of the given subcommand(s)
    list     list all managed processes
    stop     stop a process by name or pid

Common usage example

A simple example that should run as-is to showcase the main usage loop (flask and python3 required)

# create a simple flask server daemon in a file named "FLASK_SERVER"
from flask import Flask

app = Flask(__name__)

def index():
  return {"status": 200}

if __name__ == "__main__":

# make the file executable

# start the process from an executable file
eggsecutor hatch FLASK_SERVER
> Hatching process "FLASK_SERVER" and starting to track...
> egg hatched, tracking process with pid: "3670"

# check the process is healthy
eggsecutor list
> Process name    pid     status
> -----------------------------------
> FLASK_SERVER    3670    Running

# once ready shut down the server by name (or pid)
# the following are equivalent
eggsecutor stop FLASK_SERVER
eggsecutor stop 3670
> stopping process with pid: 3670

# or, if you want to stop ALL running processes being tracked
eggsecutor clear


By design, eggsecutor is meant to be a low-maintenance (and therefore, low-option) tool.

The only user-defined variable is the location of the JSON state tracking file, which defaults to


If need be, this path can be overwritten by setting the EGGSECUTOR_STATE_FILE environment variable to a valid file path (if the path does not exist, it will be created upon first usage).


~59K SLoC