Skip to content
@shep-pm

shep

A process manager written in Rust. One shepherd keeps your flock alive: restarts, logs, watch and cron restarts, webhook alerts. macOS, Linux and Windows.
shep: a process manager written in Rust. One shepherd keeps your flock alive.

crates.io downloads CI docs license

One binary runs a daemon called the shepherd. It restarts your processes when they die, captures what they print, and says plainly when something is wrong. Same feature list as pm2. Different opinions about what a supervisor owes you at 3am.

cargo install shep          # or: brew install shep-pm/shep/shep
shep welcome                # the tour, in your own terminal

shep start, stop and restart, each printing the whole flock

Every command answers with the whole flock, not just the sheep you touched. The face in the STATUS column is the fastest thing on the page to read: (o.o) online, (o~o) starting, (>_<) waiting to restart, (-.-) stopped, (x.x) errored.

What's in the fold

Repo What it is
shep The process manager. Daemon, CLI, lookout (TUI), whistle (MCP server), and the client crates your app links against.
shep-deploy A deploy dog. Watches a branch, builds a release, swaps to it, rolls back if it does not come up.
shep-discord A Discord dog. Streams a sheep's logs to a channel, drives the flock from slash commands.
shep-log-rotate A log-rotation dog. Renames grown logs, asks the shepherd to reopen, then compresses and prunes.
shep-go The Go client. Readiness, metrics and custom actions over the shepherd channel.
homebrew-shep The Homebrew tap, for macOS and Linux.
scoop-shep The Scoop bucket, for Windows.

Six crates ship from the shep repo: shep, shep-core, shep-daemon, shep-client, shep-macros and shep-channel.

How it fits together

You drive the CLI, lookout or whistle. They speak to the shepherd over a control socket. The shepherd supervises your flock and its dogs, and a sheep answers back over the shepherd channel.

A dog is a plugin the shepherd supervises for its own sake: it watches the flock rather than being part of it. Two ship inside the binary: metrics serves Prometheus, bark sends alerts. Writing your own starts from an ordinary binary, in whatever language you like.

The words

Twenty of them carry the whole product. Every themed verb keeps a straight alias that works forever, and where the joke would cost clarity it gets dropped.

Term What it means What you type
the flock Every managed process, as a set. Always the plural term. shep flock · list · ls
a sheep One managed process. Singular only, so nothing is ambiguous. shep describe web
the shepherd The daemon. Only ever the daemon. log messages, docs
bleats Logs. shep logs is the same command and always will be. shep bleats --follow
a fold A namespace or group of sheep. shep fold backend
muster Bring a saved flock back after a reboot. shep save · shep muster

All twenty terms →

Where things stand

Pre-1.0, so anything can still change. macOS, Linux and Windows, with Windows the newest of the three. Over a thousand tests, and every task ends with a mutation pass: break a line on purpose, confirm a test goes red, put it back.

Build it and tell me what breaks.

Popular repositories Loading

  1. shep shep Public

    A process manager written in Rust, and a pm2 alternative: one supervisor daemon keeps a flock of long-running processes alive on Linux, macOS and Windows

    Rust 16 9

  2. shep-deploy shep-deploy Public

    A deploy dog for shep: watches a git branch, builds a release, swaps to it, and rolls back if it does not come up

    Rust 4

  3. shep-log-rotate shep-log-rotate Public

    A log-rotation dog for shep: renames grown logs, asks the shepherd to reopen, then compresses and prunes

    Rust 3

  4. shep-go shep-go Public

    Go client for shep: readiness, metrics and custom actions over the shepherd channel

    Go 3

  5. homebrew-shep homebrew-shep Public

    Homebrew tap for shep, a process manager that keeps a flock of long-running processes alive

    Ruby 1

  6. scoop-shep scoop-shep Public

    Scoop bucket for shep, a process manager that keeps a flock of long-running processes alive

    1

Repositories

Showing 10 of 17 repositories

Top languages

Loading…

Most used topics

Loading…