Skip to content

Commit 5b4a41e

Browse files
dominikzabcikclaude
andcommitted
docs: explain the keep-awake setting for background Macs
Co-Authored-By: Claude Fable 5.2 <[email protected]>
1 parent ad75997 commit 5b4a41e

1 file changed

Lines changed: 20 additions & 3 deletions

File tree

‎docs/user/background-service.md‎

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -88,9 +88,10 @@ boot and keeps running after logout. If this needs administrator permission,
8888
setup prints a recovery command before changing the service.
8989

9090
macOS starts the service when you log in and stops it when you log out. Keep the
91-
Mac logged in and awake for unattended remote access. Installing over SSH while
92-
nobody is logged in at the Mac's screen can fail at the final start step; the
93-
service is still installed and will start at the next login.
91+
Mac logged in for unattended remote access, and see
92+
[Keep a Mac awake](#keep-a-mac-awake) so it does not sleep. Installing over SSH
93+
while nobody is logged in at the Mac's screen can fail at the final start step;
94+
the service is still installed and will start at the next login.
9495

9596
Windows background services are not supported. To keep a Windows host available
9697
through T3 Connect, leave the desktop app running with its local environment
@@ -101,6 +102,22 @@ does not configure automatic startup at Windows sign-in.
101102
`t3 up` installs the service when you set up T3 Connect, but the two are managed
102103
separately. Signing out of T3 Connect does not stop or uninstall the service.
103104

105+
## Keep a Mac awake
106+
107+
A sleeping Mac pauses its agents and cannot be reached from another device. In
108+
**Settings > Maintenance**, set **Keep computer awake** for that Mac:
109+
110+
- **While agents are working** holds off sleep until the last agent finishes,
111+
including one that is waiting for your approval.
112+
- **Always** holds off sleep for as long as T3 Code runs. Use it when you start
113+
work on the Mac from your phone or another computer.
114+
115+
The setting works the same in the desktop app, under `t3`, and for the
116+
background service, and it applies on battery too. It only prevents the Mac from
117+
sleeping when idle: the display still turns off, and closing the lid or logging
118+
out still stops agents. Linux and Windows hosts do not have this setting yet;
119+
change their sleep settings in the operating system.
120+
104121
## Keep the server responsive when agents use all memory
105122

106123
On Linux, agents already run with lower priority than the server. When they

0 commit comments

Comments
 (0)