Struct SettingsGeneral 

pub struct SettingsGeneral {
    pub autostop_delay: String,
    pub interval: String,
    pub log_file_level: String,
    pub log_level: String,
    pub mise: bool,
    pub mise_bin: String,
    pub shell: String,
    pub windows_shell: String,
    pub startup_log_timestamps: bool,
    pub ready_delay: String,
    pub worktree: bool,
}

The general.* settings.

Fields

autostop_delay: String

Delay before auto-stopping daemons when leaving a directory

When using shell hooks with auto = ["stop"], this controls how long pitchfork waits before stopping a daemon after you leave its directory.

This delay prevents unnecessary stop/start cycles when briefly switching directories.

Examples:

• "0s" - Stop immediately (no delay)
• "30s" - Wait 30 seconds
• "1m" - Wait 1 minute (default)
• "5m" - Wait 5 minutes

Set to "0s" to disable the delay and stop daemons immediately.

interval: String

Supervisor background task refresh interval

Controls how often the supervisor refreshes its internal state and checks for:

• Daemon health status changes
• Configuration file updates
• Process state synchronization

Lower values provide more responsive status updates but use more resources.

Recommended values:

• "5s" - For development/testing
• "10s" - Default, balanced
• "30s" - For production with many daemons

log_file_level: String

File log level (trace, debug, info, warn, error)

Controls the verbosity of log output written to log files. Can be set independently from log_level to have more verbose file logs.

For example, set console to "info" but file to "debug" to keep detailed logs for troubleshooting without cluttering the console.

log_level: String

Console log level (trace, debug, info, warn, error)

Controls the verbosity of log output to the console.

Available levels:

• "trace" - Most verbose, includes all internal details
• "debug" - Detailed information for debugging
• "info" - Normal operation messages (default)
• "warn" - Warnings and potential issues
• "error" - Only errors

mise: bool

Wrap daemon commands with mise x – globally

When enabled, pitchfork wraps every daemon command with mise x -- so that mise sets up the correct tool versions, PATH, and environment variables before the daemon runs.

This is especially useful when pitchfork is started as a login item or boot daemon, where the shell profile (.zshrc, .bashrc) is not sourced and tools installed via Homebrew or mise are not on PATH.

Individual daemons can override this with mise = true or mise = false in their configuration.

mise_bin: String

Explicit path to the mise binary

By default, pitchfork searches well-known locations for the mise binary:

• ~/.local/bin/mise
• ~/.cargo/bin/mise
• /usr/local/bin/mise
• /opt/homebrew/bin/mise

Set this to an absolute path if mise is installed elsewhere.

shell: String

Shell command used to execute daemon run scripts

Controls the shell used to execute daemon run commands, as well as ready_cmd / health_cmd probes, lifecycle hooks and the log archive hook.

The value is split with shell_words::split into a program and arguments, then the daemon’s run string is appended verbatim as the final argument (passed to the shell’s command flag, e.g. sh -c "<run>").

This means the run string is interpreted directly by the shell, so variable expansion ($VAR), globs (*.txt), pipes (|), and command chaining (&&) all work as expected.

Common configurations:

• "sh -c" — Default, POSIX shell
• "sh -o errexit -c" — Exit on the first failing command
• "bash -c" — Use bash instead of sh
• "bash -o errexit -o pipefail -c" — pipefail is not a POSIX option, so name a shell that has it rather than relying on sh

On Windows this setting applies only when it is set explicitly (in a config file or via PITCHFORK_SHELL); otherwise general.windows_shell is used. Setting it is the way to use one shell on every platform, e.g. "sh -c" with Git for Windows’ sh.exe on PATH.

When mise = true is enabled for a daemon, the shell wraps inside mise x --, e.g. mise x -- sh -c "<run>".

windows_shell: String

Shell command used to execute daemon run scripts on Windows

Used in place of general.shell on Windows, unless general.shell is set explicitly. Split and used the same way: the program and arguments come from this value, and the run string is appended as the final argument, e.g. cmd /C "<run>".

The default is cmd /C, which is always available, so run strings are read by cmd.exe: use %VAR% rather than $VAR, and double quotes rather than single quotes.

The split follows POSIX rules, so a path with spaces or backslashes has to be quoted: "'C:\Program Files\Git\bin\sh.exe' -c".

Common configurations:

• "cmd /C" — Default
• "powershell -Command" / "pwsh -Command" — PowerShell
• "sh -c" — Git for Windows’ sh, when Git\bin is on PATH

startup_log_timestamps: bool

Show timestamps in startup log output

When enabled, pitchfork prefixes each startup log line and result line with a timestamp (e.g. 19:03:15), making it easier to see how long each daemon took to start.

When disabled (default), a dim bullet (•) is used instead to keep the output compact and aligned with the spinner / status icons.

ready_delay: String

Default readiness delay in seconds when a daemon has no ready check configured

When a daemon has no other readiness check (output, HTTP, port, command), pitchfork waits this long before considering it ready. Daemons can override this with their own ready_delay setting.

worktree: bool

Enable git worktree / jj workspace auto-discovery

When enabled (default), pitchfork discovers git worktrees and jj workspaces for proxy hostname routing and supervisor config discovery. Each worktree gets its own namespace, and its daemons answer at <daemon>.<worktree>.<project>.<tld>.

Set to false to disable all worktree/workspace discovery. The deprecated PITCHFORK_PROXY_WORKTREE environment variable remains an alias during migration.

Implementations

impl SettingsGeneral

pub const SETTINGS_PROPS: &'static [PropMeta] = <Self as ::usage_config::Props>::PROPS

Every setting this struct declares, one entry per field, flattened groups included. The registry a build.rs used to generate, generated from the struct instead — there is no second declaration to keep in step.

pub const SETTINGS_REGISTRY: Registry

The registry over Self::SETTINGS_PROPS, for resolve, drift, and the layers.

pub const SETTINGS_SPEC: ConfigSpec

Metadata used only when lowering this declaration into a usage spec.

pub fn read(__usage_resolved: &Resolved) -> Result<Self, ReadErrors>

This resolution’s values, as the struct.

Every field is read before anything is returned, so the error is the whole list of what is wrong rather than the first thing found.

pub fn read_lossy(__usage_resolved: &Resolved) -> (Option<Self>, ReadErrors)

This resolution’s values, keeping every setting that reads.

Self::read is all or nothing, which leaves a CLI two moves when one field is bad: refuse to start, or fall back to a struct of declared defaults and lose the environment and every config file along with the offending value. Neither is a choice this crate should be making.

So: a field that will not read falls back to its own declared default and the rest keep what the merge gave them, with every failure returned alongside for the CLI to raise, log, or ignore as it sees fit. The errors are the same ::usage_config::ReadErrors Self::read returns, so a caller that decides a bad value is fatal has lost nothing by asking.

None only where a setting has no value and no declared default — a hole in the declaration rather than a bad value, and nothing to fall back to.

pub fn spec_kdl() -> String

The spec config block for these settings, as KDL.

What documents, JSON schema and completions read. A CLI deriving usage::Cli names this type in #[usage(config = ...)] instead of calling this, and its to_kdl carries the block.

Trait Implementations

impl Clone for SettingsGeneral

fn clone(&self) -> SettingsGeneral

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SettingsGeneral

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for SettingsGeneral

fn eq(&self, other: &SettingsGeneral) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Props for SettingsGeneral

const PROPS: &'static [PropMeta]

This group’s settings, in declaration order.

const PROP_SPECS: &'static [PropSpec]

Spec-only metadata parallel to Props::PROPS.

impl StructuralPartialEq for SettingsGeneral