Skip to content

pitchfork list

  • Usage: pitchfork list [FLAGS]
  • Aliases: ls
  • Effect: read-only

List all daemons

Displays a table of all tracked daemons with their PIDs, status, whether they are disabled, and any error messages.

This command shows both:

  • Active daemons (currently running or stopped)
  • Available daemons (defined in config but not yet started)

Example:

pitchfork list
pitchfork ls                    Alias for 'list'
pitchfork list --hide-header    Output without column headers
pitchfork list --status running  Show only running daemons
pitchfork ls --status available --status stopped
                                Show daemons that are available OR stopped
pitchfork list --namespace frontend
                                Show only daemons in the 'frontend' namespace
pitchfork list --project        Show only the current project's daemons

Output:

Name    Status
api     running    https://api.localhost
worker  available
db      errored    exit code 127

Flags

  • --hide-header — Hide the table header row

  • --json — Output in JSON format

  • --status <STATUS> — Filter daemons by status (repeatable for OR logic)

    Values: running, stopped, waiting, stopping, failed, errored, available, disabled

    Choices: running, stopped, waiting, stopping, failed, errored, available, disabled

  • --namespace <NAMESPACE> — Only show daemons in this namespace (repeatable for OR logic)

  • --project — Only show daemons in the current project's namespace

    The namespace is resolved from the current directory the same way short daemon IDs are: the nearest config file's namespace, falling back to 'global' when no config file is found.

  • -h --help — Print help

MIT LicenseCopyright © 2026jdx.dev