https://github.com/narcotic-sh/modafinil

Let your agents run while your MacBook lid is closed
https://github.com/narcotic-sh/modafinil

caffeinate macos pmset sleep

Last synced: 1 day ago
JSON representation

Let your agents run while your MacBook lid is closed

• Host: GitHub
• URL: https://github.com/narcotic-sh/modafinil
• Owner: narcotic-sh
• License: mit
• Created: 2026-05-09T21:04:24.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-06-17T06:50:43.000Z (16 days ago)
• Last Synced: 2026-06-17T08:24:53.873Z (16 days ago)
• Topics: caffeinate, macos, pmset, sleep
• Language: Swift
• Homepage: https://modafinil.dev
• Size: 564 KB
• Stars: 135
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Modafinil

A macOS menu bar app that prevents your MacBook from falling asleep, both when the lid is open and when the lid is closed.

When the lid is closed, it lets the display turn off like normal to preserve battery and reduce heat.

Motivated by the need to let coding agents stay running while you carry your MacBook around.



  



## Installation & Usage

Install through the latest `.dmg` in Releases. Supports both Apple Silicon and Intel Macs (universal binary).

Requires App Background Activity permission (`System Settings -> General -> Login Items & Extensions`). Should pop up automatically on first activation.

Left click to activate/deactivate. Right click for menu, where you can optionally set a time limit, quit the app, and also uninstall it.

Requires macOS 13+.