procman

A foreman-like process supervisor written in Rust. Reads a procman.yaml, spawns all listed commands, multiplexes their output with name prefixes, and tears everything down cleanly when any child exits or a signal arrives.

Usage

cargo install --path .

procman run — run all commands

procman run                  # uses ./procman.yaml
procman run myapp.yaml       # custom config path

Bare procman with no subcommand is equivalent to procman run.

procman serve — accept dynamic commands via a FIFO

procman serve /tmp/myapp.fifo &

Runs all procman.yaml commands and listens on a named FIFO for dynamically added commands. The FIFO is created automatically and removed on exit.

procman start — send a command to a running server

procman start /tmp/myapp.fifo "redis-server --port 6380"

Opens the FIFO for writing and sends the command line. Fails immediately if no server is listening. The server parses the command using the same rules as command lines (including env var substitution).

Scripted service bringup

The serve/start pattern enables imperative orchestration — start a supervisor, wait for dependencies to become healthy, then add dependent services:

procman serve /tmp/myapp.fifo &
while ! curl -sf http://localhost:8080/health; do sleep 1; done
procman start /tmp/myapp.fifo "redis-server --port 6380"

An advisory flock on procman.yaml prevents multiple instances from managing the same file simultaneously.

procman.yaml Format

web:
  env:
    PORT: "3000"
  run: serve --port $PORT

worker:
  depends:
    - url: http://localhost:3000/health
      code: 200
      poll_interval: 2s
      timeout: 30s
  run: process-jobs

setup:
  depends:
    - path: /tmp/ready.flag
  run: post-setup-task

• Each top-level key is a process name.
• run (required): the command to execute (parsed with POSIX shell quoting).
• env (optional): per-process environment variables.
• depends (optional): list of dependencies that must be satisfied before the process starts.
  • HTTP health check: url + code (expected status), with optional poll_interval and timeout.
  • File exists: path to a file that must exist.

Behavior

• All children share a process group.
• stderr is merged into stdout per-process.
• Output is prefixed with the process name, right-aligned and padded.
• Per-process logs are written to ./procman-logs/<name>.log (directory is recreated each run).
• A combined ./procman-logs/procman.log contains the full interleaved formatted output (same as stdout).
• On SIGINT or SIGTERM, all children receive SIGTERM. After a 2-second grace period, remaining processes are sent SIGKILL.
• procman exits with the first child's exit code.

License

MIT