All pages
Docs · Background features
Awake
Availability: macOS only. IOKit power assertions.
The Awake monitor (in the Jobs tab of the right sidebar, below the job list) prevents the Mac from sleeping while something important is running. Unlike toggling caffeinate by hand, TRMNLY ties each assertion to the actual reason the machine should stay awake, so it never gets stuck on.
What keeps it awake
- A running command in any pane holds an assertion automatically — the moment the foreground process returns to the shell prompt, it's released. The in-app agent holds one for the duration of a turn, too. A coding agent in a pane (Claude Code, Codex and the like) holds one only while it's working, not while it sits at its prompt waiting for you, so an open session doesn't stop the Mac sleeping. TRMNLY goes by the agent's title: a working spinner keeps the Mac awake and the waiting mark lets it sleep, even when a helper (an MCP server, the Chrome bridge) is using a little CPU in the background. Gated by Settings → General → Sleep → "Keep Mac awake while tasks are running" (on by default).
- A draining prompt queue holds a single assertion while any terminal queue has pending entries, covering the gaps between commands on an overnight drain. Also on by default, with its own Sleep toggle.
- Idle mode — "never sleep while TRMNLY is open." A manual toggle in the same Sleep settings section, off by default; releases on quit.
- The agent can hold explicit claims via the
awake_acquire/awake_release/awake_statustools (each claim carries areason; agent-held claims are capped at 8, andawake_preferencesflips the toggles above).
What it doesn't do
- No display-sleep prevention. The screen still dims; only system idle sleep is blocked.
- Closing the lid still sleeps the Mac — macOS doesn't let apps prevent clamshell sleep. Leave the lid open, or use an external display on AC power.
- If you quit TRMNLY, every assertion goes away.
Inspecting
The monitor shows who's currently holding an assertion: the reason string, how long it's been held, and an estimated time remaining when one is known. Each row has a Stop button (and a Stop all when several are active) — useful when "why is my fan loud at 3 a.m." turns out to be a forgotten test runner. Stopping a command's claim suppresses it for that command only; the next command keeps the Mac awake again.