narcotic-sh

narcotic-sh / modafinil

Public

Let your agents run while your MacBook lid is closed

caffeinate macos pmset sleep
57
1
100% credibility
Found May 10, 2026 at 57 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A macOS menu bar app that prevents MacBooks from sleeping when the lid is closed, while allowing the display to turn off for battery savings.

How It Works

1
💡 Discover Modafinil

You hear about this simple menu bar app that keeps your MacBook running smoothly even when you close the lid, perfect for letting tasks like coding helpers continue while you're on the move.

2
📥 Download the installer

Head to the releases page and download the easy-to-use installer file.

3
🚀 Install and launch

Double-click the downloaded file to install, then find the eye icon in your menu bar and open it.

4
✅ Grant background permission

When a notice pops up, allow the app to run in the background so it can keep watch over your laptop's lid.

5
🔄 Turn wakefulness on

Left-click the menu bar icon to switch it on – you'll see the eye icon light up.

6
💻 Close the lid and go

Shut your MacBook lid; the screen dims to save battery and reduce heat, but everything inside keeps humming along.

🎉 Tasks run freely

Now carry your laptop anywhere while long-running jobs like AI coding agents finish without your Mac falling asleep.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 57 to 57 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is modafinil?

Modafinil is a Swift-based macOS menu bar app that stops your MacBook from sleeping when you close the lid, letting agents run uninterrupted—like GitHub Copilot's agent mode handling heavy lifting in VS Code—while turning off the display to save battery and cut heat. Install via DMG, grant background activity permission once, then left-click the icon to toggle on/off or right-click for quit/uninstall. Built for Apple Silicon on macOS 13+, it checks for external displays and uses pmset commands via privileged helper for secure sleep control.

Why is it gaining traction?

It stands out by safely disabling sleep without root hacks or third-party tools, auto-handling lid-close display shutdown, and cleaning up on quit/uninstall to restore normal behavior. Devs love the simple toggle for keeping coding agents churning during commutes, unlike clunky alternatives that drain battery or risk security. The "let your agents run" hook resonates in automation workflows, evoking modafinil 200mg focus for holiday let agents or letting agents transform data quality.

Who should use this?

AI agent wranglers on MacBooks running long tasks like GitHub let's build from here scripts or letting agents move emails in Salesforce. DevOps folks testing automation on portables, or backend devs letting agents near me deduplicate records without sleep interruptions. Skip if you're on Intel or need multi-user support.

Verdict

Grab it if you match the niche—57 stars and 1.0% credibility score signal early maturity with thin docs and single-platform testing, but the clean UX and proper privileged setup make it worth the quick DMG try for agent-heavy flows.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.