pitchfork daemons add

• Usage: pitchfork daemons add [FLAGS] <ID> [ARGS]…
• Aliases: a

Add a new daemon to pitchfork.toml

Creates a new daemon configuration section in the pitchfork.toml file. The daemon will be added to the nearest pitchfork.toml found in the filesystem hierarchy starting from the current directory.

Examples: pitchfork daemons add api bun run server Add daemon using positional args pitchfork daemons add api --run 'npm start' Add daemon with explicit run command pitchfork daemons add api -- bun run server Add daemon with explicit args after -- pitchfork daemons add api --run 'npm start' --retry 3 Add with retry policy pitchfork daemons add api --run 'npm start' --watch 'src/**/*.ts' Add with file watching pitchfork daemons add api --run 'npm start' --autostart --autostop Add with auto start/stop hooks pitchfork daemons add worker --run './worker' --depends api Add with daemon dependency pitchfork daemons add api --run 'npm start' --local Add to pitchfork.local.toml instead pitchfork daemons add worker --run './worker' --cron-schedule '0 * * * *' --cron-immediate Add cron daemon that triggers immediately

Arguments

<ID>

ID of the daemon to add (e.g., "api" or "namespace/api")

[ARGS]…

Arguments to pass to the daemon (alternative to --run)

Flags

--run <RUN>

Command to run (can also use positional args)

--retry <RETRY>

Number of retry attempts on failure (use "true" for infinite)

--watch… <WATCH>

Glob patterns to watch for changes (can be specified multiple times)

--dir <DIR>

Working directory for the daemon

--env… <ENV>

Environment variables in KEY=value format (can be specified multiple times)

--ready-delay <READY_DELAY>

Delay in seconds before considering daemon ready

--ready-output <READY_OUTPUT>

Regex pattern to match in output for readiness

--ready-http <READY_HTTP>

HTTP endpoint URL to poll for readiness

--ready-port <READY_PORT>

TCP port to check for readiness

--ready-cmd <READY_CMD>

Shell command to poll for readiness

--expected-port… <EXPECTED_PORT>

Ports the daemon is expected to bind to (can be specified multiple times or comma-separated)

--bump [BUMP]

Automatically find an available port if the expected port is in use

--depends… <DEPENDS>

Daemon dependencies that must start first (can be specified multiple times)

--boot-start

Start this daemon automatically on system boot

--autostart

Autostart the daemon when entering the directory

--autostop

Autostop the daemon when leaving the directory

--on-ready <ON_READY>

Command to run when daemon becomes ready

--on-fail <ON_FAIL>

Command to run when daemon fails

--on-retry <ON_RETRY>

Command to run before each retry attempt

--on-stop <ON_STOP>

Command to run when the daemon is explicitly stopped by pitchfork

--on-exit <ON_EXIT>

Command to run on any daemon termination (clean exit, crash, or stop)

--cron-schedule <CRON_SCHEDULE>

Cron schedule expression (6 fields: second minute hour day month weekday)

--cron-retrigger <CRON_RETRIGGER>

Cron retrigger behavior: finish, always, success, fail

--cron-immediate

Trigger cron immediately on first check (default: deferred until next scheduled time)

--local

Write to pitchfork.local.toml instead of pitchfork.toml

--project

Write to pitchfork.toml explicitly (default if no flag specified)