1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
<!--
launchd unit for zero-headlessd.
Install to: ~/Library/LaunchAgents/dev.getzero.headless.plist
Load with: launchctl load -w ~/Library/LaunchAgents/dev.getzero.headless.plist
Unload with: launchctl unload -w ~/Library/LaunchAgents/dev.getzero.headless.plist
Path-substitution: replace `REPLACE_HOME` with the operator's
absolute $HOME and `REPLACE_BIN` with the absolute path to
the installed `zero-headlessd` binary (typically
`$HOME/.cargo/bin/zero-headlessd`). The `zero headless install`
subcommand (M2 ยง8) does this substitution on the operator's
behalf; this file ships as the canonical template.
-->
Label
dev.getzero.headless
ProgramArguments
REPLACE_BIN
<!--
Background-only: the supervisor does not render a UI and
should not be treated as a foreground app by launchd.
Matches the M2 spec's `ProcessType=Interactive=false`.
-->
ProcessType
Background
<!--
Relaunch on crash but not faster than every 10 s. Kept
identical to the systemd `RestartSec=10` so operators
can reason about restart cadence without a platform
switch. Faster restart risks tight-looping on a broken
config and burning the operator's log budget.
-->
KeepAlive
ThrottleInterval
10
<!--
Run at user login. The supervisor's domain is
"operator-local" (M2 spec ADR-006), not system-global;
installing under `LaunchAgents` rather than
`LaunchDaemons` is the correct scope.
-->
RunAtLoad
<!--
Clamp file-descriptor + process limits. The daemon serves
one accept loop and spawns a handful of short-lived
handler tasks; these ceilings are 10x what the hot path
needs, which is the engineering sweet spot for "surprise
when exceeded but not a starvation risk".
-->
SoftResourceLimits
NumberOfFiles
1024
NumberOfProcesses
128
StandardOutPath
REPLACE_HOME/.zero/logs/headless.out.log
StandardErrorPath
REPLACE_HOME/.zero/logs/headless.err.log
EnvironmentVariables
ZERO_LOG
info