LidGuard: Skill for Codex

LidGuard Power Runtime

Platform Power Control

Windows

• Use PowerCreateRequest, PowerSetRequest, and PowerClearRequest for normal idle sleep prevention.
• Use PowerRequestSystemRequired to prevent idle system sleep.
• Use PowerRequestAwayModeRequired to request away-mode behavior where supported.
• Keep PowerRequestDisplayRequired optional; use it only when display sleep should also be prevented.
• Always clear power requests and close handles when protection ends.
• Do not change sleep idle timeouts. Runtime crashes could leave the user's system policy in a dangerous state.

Linux

• Target systemd/logind environments.
• Use systemd-inhibit block inhibitors for normal sleep and idle prevention.
• Map PreventSystemSleep to the sleep inhibitor.
• Map PreventSystemSleep and PreventDisplaySleep to the idle inhibitor.
• Keep PreventAwayModeSleep Windows-only; do not expose or apply it in Linux settings/help output.
• Map temporary lid-close protection to a separate handle-lid-switch inhibitor only when ChangeLidAction is enabled.
• Keep SystemdInhibitor releasing normally by closing stdin on the helper process; use process-tree kill only as fallback.
• Tie inhibitor helper processes to the LidGuard runtime lifetime so stale orphaned inhibitors do not survive the runtime.
• Request immediate sleep/hibernate with systemctl suspend or systemctl hibernate, returning exit code/stderr when the request fails.
• Keep Linux as a supported top-level platform when OperatingSystem.IsLinux() is true, even when systemd/logind prerequisites are incomplete; report missing prerequisites from the specific runtime or diagnostic operation.
• Do not depend on a long-lived sudo -v cache. Prepare persistent privileged logind actions through the Linux polkit rule command.

macOS

• Target local macOS systems with caffeinate, pmset, ioreg, system_profiler, Apple Silicon IOHIDEventSystemClient temperature sensors, and best-effort powermetrics.
• Allow the Apple Silicon temperature fast path to use direct source-generated LibraryImport calls into CoreFoundation and IOKit, plus NativeLibrary export lookup for CoreFoundation callback tables, because CsWin32 does not cover macOS frameworks.
• Use caffeinate assertions for normal idle sleep prevention.
• Map PreventSystemSleep to caffeinate -i.
• Map PreventDisplaySleep to caffeinate -d.
• Do not use caffeinate -s for LidGuard's cross-platform PreventAwayModeSleep setting. Away-mode sleep prevention is Windows-only, and macOS sleep prevention must rely on caffeinate -i so it works on AC and DC power.
• Map temporary lid-close protection to pmset -a disablesleep 1 only when ChangeLidAction is enabled.
• Before changing SleepDisabled, save the original state through the pending lid-action backup JSON path; restore it when protection ends or during the next CLI recovery path before normal command execution.
• Request immediate Sleep with pmset sleepnow.
• For Hibernate, temporarily back up the current supported hibernatemode, write hibernatemode 25, request pmset sleepnow, and leave the pending hibernatemode backup for the next CLI recovery path instead of restoring it immediately after pmset sleepnow returns. If pmset sleepnow fails, roll back the hibernatemode immediately when possible.
• Use non-interactive sudo -n only for the exact commands allowed by macos-permission install; fail with actionable setup guidance instead of prompting in background runtime paths.