D
devasahithiyan/NeverSleep
Close your MacBook lid and keep AI agents and chosen apps running in the background — no more half-closed lid
View on GitHub ↗Link checked 2026-11-13 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"devasahithiyan-neversleep": {
"command": "npx",
"args": ["wrangler"]
}
}
}Parsed from the README we fetched on 2026-11-12; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"devasahithiyan-neversleep": {
"command": "npx",
"args": ["wrangler"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio devasahithiyan-neversleep -- npx wrangler
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 0 ★ · devasahithiyan/NeverSleep · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-13 · last seen 2026-11-14 · seen 2× · listed by 1 sources
- Score
- score 103 · 1 sources · repo
- Install
npx wrangler
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx wrangler. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: 开源项目. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
devasahithiyan/NeverSleep；first catalogued 2026-11-13；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# NeverSleep
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Close your MacBook lid and keep your AI agents and apps running in the background. No more leaving the lid half-closed.
The goal of this project is simple. You start a long job on your Mac: an AI coding agent, a model download, a build, a scraper, a render. Then you need to leave, and the job stops when you close the lid. The usual workarounds are keeping the lid propped half-open, or plugging in an external display. NeverSleep lets you close the lid properly and keeps only the apps you chose running. You can check on the Mac and control it from your phone's browser.
macOS menu bar app · privileged helper · Cloudflare relay · mobile web dashboard
## What it does
Keeps chosen apps running with the lid closed. Pick apps from an allow-list, such as your terminal, Claude, Cursor, Ollama, a browser or a download manager. Everything else is paused (SIGSTOP) while the lid is closed, so it doesn't drain the battery, and resumed (SIGCONT) when you open it.
Safety cutoffs. Below a battery level (default 20%, only when unplugged), or when macOS reports serious or critical thermal pressure, NeverSleep resumes everything, re-enables sleep and puts the Mac to sleep.
Remote dashboard in any browser. Nothing to install on your phone. You see:
battery, charging and time remaining
lid state and thermal state
running apps, with Pause / Resume / Quit / Force quit
a search to open any installed app
lid mode on/off
the allow-list editor
online status and last seen
No passwords. A browser signs in by typing a one-time code shown in the Mac's menu bar.
Crash-safe. If NeverSleep quits, crashes or is killed, sleep is re-enabled and every paused app is resumed.
## How it works
macOS can't keep one app awake while the rest of the Mac sleeps, so NeverSleep keeps the whole Mac awake with pmset disablesleep 1. That's the same mechanism Amphetamine's closed-lid mode uses; caffeinate and power assertions don't stop lid-close sleep. It then freezes every app that's not on your list. When the lid opens, the frozen apps resume and normal sleep returns.
┌──────────── Your Mac ────────────┐ ┌──── Cloudflare (free plan) ────┐ ┌── Any browser ──┐
│ NeverSleep.app (menu bar) │ outbound │ Worker + Durable Objects │ HTTPS │ Dashboard │
│ • watches the lid (IOKit) │ WebSocket │ • one Durable Object per Mac │◀──────▶│ (phone/laptop) │
│ • pauses/resumes apps │──────────▶ │ • pairing + sign-in codes │ └─────────────────┘
│ • battery + thermal cutoffs │ (TLS) │ • fixed, validated commands │
│ NeverSleepHelper (root daemon) │ │ • static dashboard │
│ • only: pmset disablesleep 0|1 │ └────────────────────────────────┘
└──────────────────────────────────┘
The Mac only makes outbound connections, so it works behind any router or NAT, with no port forwarding.
## Requirements
A MacBook running macOS 14 Sonoma or later (Apple Silicon or Intel)
Xcode Command Line Tools (xcode-select --install). Full Xcode is not needed.
Node.js 18+ and a free Cloudflare account, only if you want the remote dashboard
## Quick start
### 1. Deploy your relay (for the remote dashboard)
Everyone runs their own relay, so your Mac never talks to someone else's server.
bash
git clone https://github.com/devasahithiyan/NeverSleep.git
The goal of this project is simple. You start a long job on your Mac: an AI coding agent, a model download, a build, a scraper, a render. Then you need to leave, and the job stops when you close the lid. The usual workarounds are keeping the lid propped half-open, or plugging in an external display. NeverSleep lets you close the lid properly and keeps only the apps you chose running. You can check on the Mac and control it from your phone's browser.
macOS menu bar app · privileged helper · Cloudflare relay · mobile web dashboard
## What it does
Keeps chosen apps running with the lid closed. Pick apps from an allow-list, such as your terminal, Claude, Cursor, Ollama, a browser or a download manager. Everything else is paused (SIGSTOP) while the lid is closed, so it doesn't drain the battery, and resumed (SIGCONT) when you open it.
Safety cutoffs. Below a battery level (default 20%, only when unplugged), or when macOS reports serious or critical thermal pressure, NeverSleep resumes everything, re-enables sleep and puts the Mac to sleep.
Remote dashboard in any browser. Nothing to install on your phone. You see:
battery, charging and time remaining
lid state and thermal state
running apps, with Pause / Resume / Quit / Force quit
a search to open any installed app
lid mode on/off
the allow-list editor
online status and last seen
No passwords. A browser signs in by typing a one-time code shown in the Mac's menu bar.
Crash-safe. If NeverSleep quits, crashes or is killed, sleep is re-enabled and every paused app is resumed.
## How it works
macOS can't keep one app awake while the rest of the Mac sleeps, so NeverSleep keeps the whole Mac awake with pmset disablesleep 1. That's the same mechanism Amphetamine's closed-lid mode uses; caffeinate and power assertions don't stop lid-close sleep. It then freezes every app that's not on your list. When the lid opens, the frozen apps resume and normal sleep returns.
┌──────────── Your Mac ────────────┐ ┌──── Cloudflare (free plan) ────┐ ┌── Any browser ──┐
│ NeverSleep.app (menu bar) │ outbound │ Worker + Durable Objects │ HTTPS │ Dashboard │
│ • watches the lid (IOKit) │ WebSocket │ • one Durable Object per Mac │◀──────▶│ (phone/laptop) │
│ • pauses/resumes apps │──────────▶ │ • pairing + sign-in codes │ └─────────────────┘
│ • battery + thermal cutoffs │ (TLS) │ • fixed, validated commands │
│ NeverSleepHelper (root daemon) │ │ • static dashboard │
│ • only: pmset disablesleep 0|1 │ └────────────────────────────────┘
└──────────────────────────────────┘
The Mac only makes outbound connections, so it works behind any router or NAT, with no port forwarding.
## Requirements
A MacBook running macOS 14 Sonoma or later (Apple Silicon or Intel)
Xcode Command Line Tools (xcode-select --install). Full Xcode is not needed.
Node.js 18+ and a free Cloudflare account, only if you want the remote dashboard
## Quick start
### 1. Deploy your relay (for the remote dashboard)
Everyone runs their own relay, so your Mac never talks to someone else's server.
bash
git clone https://github.com/devasahithiyan/NeverSleep.git
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/devasahithiyan-neversleep/)
- Source
- github · https://github.com/devasahithiyan/NeverSleep
- Browse by field
- Open source
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.