shep
Rust process manager whose daemon keeps long-running processes alive, restarts them, and captures output.
Tested on macOS and Linux
Use it
macOS arm64
You need first
- System packages:
Visual C++ redistributable
Download prebuilt aarch64-apple-darwin archive and verify sha256
mkdir -p ~/.local/bin /tmp/shep-dl && curl -fL -o /tmp/shep-dl/shep.tar.gz https://github.com/shep-pm/shep/releases/download/shep-v0.19.0/shep-aarch64-apple-darwin.tar.gz && curl -fL -o /tmp/shep-dl/shep.sha256 https://github.com/shep-pm/shep/releases/download/shep-v0.19.0/shep-aarch64-apple-darwin.sha256 && cat /tmp/shep-dl/shep.sha256 && (cd /tmp/shep-dl && shasum -a 256 shep.tar.gz) && tar tzf /tmp/shep-dl/shep.tar.gzExtract archive and install shep binaries to ~/.local/bin
tar xzf /tmp/shep-dl/shep.tar.gz -C /tmp/shep-dl && install -m 755 /tmp/shep-dl/shep /tmp/shep-dl/shep-runtime /tmp/shep-dl/shep-dev ~/.local/bin/ && ls -l ~/.local/bin/shep* && ~/.local/bin/shep --version
Check that it works
shep --versionThe output should contain “shep 0.19.0”.
First thing to try
shep welcome 2>&1Run shep welcome to get started.
Linux x86_64
You need first
- System packages:
Visual C++ redistributable
download and extract shep binary release
curl -fsSL https://github.com/shep-pm/shep/releases/download/shep-v0.19.0/shep-x86_64-unknown-linux-gnu.tar.gz -o /tmp/shep.tar.gz && mkdir -p /tmp/shep_ex && tar -xzf /tmp/shep.tar.gz -C /tmp/shep_exinstall shep binaries to local bin
mkdir -p ~/.local/bin && cp /tmp/shep_ex/shep /tmp/shep_ex/shep-runtime /tmp/shep_ex/shep-dev ~/.local/bin/ && chmod +x ~/.local/bin/shep ~/.local/bin/shep-runtime ~/.local/bin/shep-dev && shep --version
Check that it works
shep --versionThe output should contain “shep 0.19.0”.
First thing to try
shep welcomeRun shep welcome to get started.
What it does
- Keep long-running processes aliveTested
How to use it
- List your apps with a name and script in a
Flockfile.toml. - Run
shep start ./Flockfile.tomlfrom that folder to start them under the daemon.
- List your apps with a name and script in a
- Capture what your processes printTested
How to use it
- Start your apps with
shep start ./Flockfile.toml. - Run
shep bleats --no-follow --lines <number>to see recent output from each app.
- Start your apps with
- Restart processes when they dieNot tested
How far pickfit got
macOS arm64
- Installs
- Starts
- 2 of 3 features work
- Works offline
Linux x86_64
- Installs
- Starts
- 2 of 3 features work
- Works offline
Other systems
Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- keep long-running processes alive and restart them when they die
- capture what supervised processes print
- follow aggregated process output logs
- import pm2 saved process list into a Flockfile
- let an agent host query the flock over Model Context Protocol
An alternative to pm2.
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.19.0
Differences the test machine hit
- README: brew install shep-pm/shep/shep
In the test: Used README prebuilt archive shep-aarch64-apple-darwin.tar.gz (v0.19.0) verified with .sha256 and installed shep, shep-runtime, shep-dev to ~/.local/bin - README: shep bleats --no-follow --lines 4 shows only app output
In the test: bleats also prints notice[log_missing] lines for disabled built-in bark and metrics dogs
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.19.0
Differences the test machine hit
- README: cargo install shep
In the test: used prebuilt release archive shep-x86_64-unknown-linux-gnu.tar.gz v0.19.0 from GitHub releases and copied shep, shep-runtime, shep-dev to ~/.local/bin - README: shep bleats --no-follow --lines 4 prints only sheep lines
In the test: bleats still exits 0 and prints sheep output on stdout; missing bark/metrics log notices go to stderr