codex-clamshell v1.0.0

codex-clamshell v1.0.0

Keep OpenAI Codex Desktop running on a MacBook with the lid closed, then automatically restore normal macOS sleep when Codex becomes idle.

Highlights

• Detects the power assertion created by Codex's Prevent sleep while running setting
• Blocks macOS clamshell sleep only while Codex is actively working
• Restores sleep when Codex finishes, pauses for input, or becomes idle
• Immediately sleeps when work ends while the MacBook lid remains closed
• Installs as a root-owned LaunchDaemon and starts automatically with macOS
• Includes safe install and uninstall scripts, diagnostics, CI, and MIT licensing

Install

git clone https://github.com/llmpolska/codex-clamshell.git
cd codex-clamshell
./install.sh

Enable Prevent sleep while running in Codex Desktop before use.

Built by LLM Polska.