Quick Start

Get pitchfork running in under 5 minutes.

Install

# Using mise (recommended)
mise use -g pitchfork

# Or with cargo
cargo install pitchfork-cli

# Or download from GitHub releases
# https://github.com/jdx/pitchfork/releases

Run Your First Daemon

Start a background process with a single command:

pitchfork run myserver -- python -m http.server 8000

This starts a Python HTTP server in the background, labeled "myserver".

Check Status

pitchfork list

You'll see output like:

NAME       PID    STATUS
myserver   12345  running

View Logs

pitchfork logs myserver

Or follow logs in real-time:

pitchfork logs myserver --tail

Interactive Dashboard

For a richer monitoring experience, launch the terminal UI:

pitchfork tui

The TUI features vim-style keybindings, fuzzy search, and a built-in config editor.

Stop the Daemon

pitchfork stop myserver

What's Next?

• Installation - All installation methods and shell completion
• Your First Project - Set up a project with multiple daemons
• Shell Hook - Auto-start daemons when entering a directory