Show HN: Bulchimbeon, a night watch keep your Mac awake while AI agents work Developer s3onghyun released Bulchimbeon, a macOS menu bar app that keeps a Mac awake only while AI coding agents are actively working, then releases the sleep block when they finish. Bulchimbeon 0.12.6 and later is signed with a Developer ID and notarized by Apple, installs via the Homebrew cask s3onghyun/tap/bulchimbeon, requires macOS 13 or later, and supports Claude Code, Codex, Gemini CLI, Cursor Agent, Copilot CLI, Aider and OpenCode, with a separate Linux daemon offering the same function. The app uses no hooks, daemon or installed root helper, and a --diagnose flag reports what it detects. Your Mac's night-watch soldier. A menu bar app that keeps your Mac awake only while your AI coding agents are actually working , then salutes "Shift over " and lets it sleep. No hooks, no daemon, no installed root helper. One app. macOS 13 and later. On Linux, a small daemon with a command line and a tray icon does the same job: see Linux linux . Bulchimbeon 불침번 is the night-watch duty in the Korean army: someone stays up all night so everyone else can sleep. A pixel-art private takes that shift for your Mac. 🌐 한국어 https://github.com/s3onghyun/bulchimbeon/blob/main/README.ko.md · 日本語 https://github.com/s3onghyun/bulchimbeon/blob/main/README.ja.md · 简体中文 https://github.com/s3onghyun/bulchimbeon/blob/main/README.zh-CN.md 💡 Ideas / 문의 / 建议 https://github.com/s3onghyun/bulchimbeon/discussions 🗳️ Which agent do you use it with? Where did you get stuck? Vote and tell us https://github.com/s3onghyun/bulchimbeon/discussions/64 Install: brew install --cask s3onghyun/tap/bulchimbeon — or download the latest macOS zip https://github.com/s3onghyun/bulchimbeon/releases and move it to /Applications . First launch: from 0.12.6 the app is signed with a Developer ID and notarized by Apple, so it just opens. At most, macOS asks once whether to open an app downloaded from the internet: click Open . When it asks whether Bulchimbeon may send notifications, allow it; notifications then come from Bulchimbeon itself. 0.12.5 and earlier: Open Anyway is needed once Those versions are ad-hoc signed and not notarized, so macOS blocks them once: 1. Open Bulchimbeon. macOS says it can't be opened; click Done . 2. Go to System Settings → Privacy & Security and scroll down to Security . 3. Next to "Bulchimbeon" was blocked , click Open Anyway , then confirm. Since macOS 15, right-click → Open no longer bypasses this. Their notifications show up as "Script Editor" , because macOS won't grant an unnotarized app notification permission of its own. Updating to 0.12.6 or later removes both. Supported agents: Claude Code · Codex · Gemini CLI · Cursor Agent · Copilot CLI · Aider · OpenCode and your own custom agents . Paste this into Claude Code, Codex, Gemini CLI or another coding agent. The agent follows docs/install-for-agents.md https://github.com/s3onghyun/bulchimbeon/blob/main/docs/install-for-agents.md and leaves any first-launch prompt from macOS to you. Install Bulchimbeon https://github.com/s3onghyun/bulchimbeon on this computer by following https://raw.githubusercontent.com/s3onghyun/bulchimbeon/main/docs/install-for-agents.md step by step. Show me each command before you run it. Rules: install only from the Homebrew cask s3onghyun/tap/bulchimbeon or github.com/s3onghyun/bulchimbeon releases, and check the SHA-256 of anything you download. No sudo for the Mac app. Never remove the quarantine attribute xattr or turn off Gatekeeper spctl : if macOS asks about or blocks the first launch, stop and let me answer it myself. Finish by checking with me that Agent watch is ticked in the menu. 1. Click the private in the menu bar and check that 🤖 Agent watch auto shift is ticked. Agent watch is on by default; if you turned it off, tick it. The app remembers your choice. 2. Give an agent a task, for example ask Claude Code to run your tests. 3. Within a few seconds the private in the menu bar turns his flashlight on. 4. Open the menu. Below the welcome note shown until you click Got it , the status line reads Bulchimbeon — On duty · 0:12 · … , and the line under it says why, such as Claude Code working . 5. Nothing happens? Run /Applications/Bulchimbeon.app/Contents/MacOS/Bulchimbeon --diagnose to see what it detects, and tell us where you got stuck https://github.com/s3onghyun/bulchimbeon/discussions/64 . To see the sleep block macOS itself is holding, run pmset -g assertions . While on watch: 2026-10-31 13:17:17 +0900 Assertion status system-wide: BackgroundTask 0 ApplePushServiceTask 0 UserIsActive 0 PreventUserIdleDisplaySleep 0 SoftwareUpdateTask 0 PreventSystemSleep 0 ExternalMedia 0 PreventUserIdleSystemSleep 1 NetworkClientActive 0 Listed by owning process: pid 2102 Bulchimbeon : 0x002847ba00019690 13:31:53 PreventUserIdleSystemSleep named: "Bulchimbeon on duty: keeping AI agents awake" Kernel Assertions: 0x100=MAGICWAKE id=592 level=255 0x100=MAGICWAKE creat= mod= description=en0 owner=IOSkywalkNetworkBSDClient - 2026-10-31 13:17:17 +0900 : when the command ran. - Assertion status system-wide : every kind of sleep block, with how many are held right now. PreventUserIdleSystemSleep 1 means something is keeping the Mac from idle sleep. PreventUserIdleDisplaySleep 0 means the display may still sleep, the default watch mode. With Keep display on , Bulchimbeon takes a display block instead, so PreventUserIdleDisplaySleep reads 1 and Bulchimbeon's own line below shows that kind. - Listed by owning process : who holds each block. pid 2102 Bulchimbeon is the app your pid will differ , 0x002847ba00019690 is the block's ID, and 13:31:53 is when the watch took it. That time has no date, so it can be from an earlier day and read later than the header time. PreventUserIdleSystemSleep is its kind PreventUserIdleDisplaySleep with Keep display on , and named: "Bulchimbeon on duty: keeping AI agents awake" is the fixed name to look for. Other apps holding the Mac awake would be listed here too. - Kernel Assertions : macOS's own entries here a network wake for en0 , not from Bulchimbeon; yours may differ. Captured on macOS 26.6.2, Apple Silicon, Bulchimbeon 0.11.0. While idle no agent working , Bulchimbeon releases its block, so pmset -g assertions | grep -i bulchimbeon prints no Bulchimbeon line. Why not just use caffeinate or Amphetamine? Those are great when you want a manual, fixed wake lock. Bulchimbeon starts and ends the lock around active AI-agent work, so it does not get left on overnight. What does it inspect or send? It uses no hooks. Its only network request is the once-a-day update check updates , which sends nothing but its version and can be turned off. It observes only your own local process metadata to decide whether a supported agent is working; it never stores or prints process command lines or environment variables. Can it keep a closed laptop awake? Yes, but turning on the lid-closed mode requires an administrator approval. It restores normal lid sleep when the watch ends or the app quits. | State | The private | When | |---|---|---| | 💤 Off duty | Dozing in his helmet, zzz | Nothing to guard | | 👀 Standing by | Looking around | Waiting for an agent to clock in | | 🪖 On duty | Flashlight on, on patrol | The Mac won't sleep | | 🫡 Shift over | ^ ^ salute | Agents went quiet / watch time is up | | 🥵 Combat rest | Sweating, eyes closed | The Mac is overheating | The private patrols just under your menu bar with a flashlight. While standing by he looks around in the corner; at shift change he salutes with a speech bubble. Clicks pass straight through, he fades when your pointer comes close, and he stays out of full-screen apps presentations, screen sharing, video . Size 2× / 3×, or turn him off. | When | He says | |---|---| | On watch | "Won't doze off …probably." · "Sleep tight. I've got this " | | Standing by | "Polishing my rifle… standing by." | | Mac heating up | "Heat advisory Hydrating 🥵" → "Combat rest Cooling down 🧊" | | Low battery | "Reporting to the duty officer 🔋 Battery at 15%… out of strength, standing down. Plug in within 10 minutes and I'll stand watch again." | | Sleep block lost | "Not AWOL Back on post 🫡" | | You come back | "Handover report 📋" | To leave an agent running overnight I used to do this: caffeinate -d ...and forget to turn it off sudo pmset disablesleep 1 ...and forget to turn it back on → battery at 0% Bulchimbeon stays awake only while an agent is working and hands the Mac back to normal sleep when it's done. | Feature | What it does | |---|---| | 🤖 Agent watch | Detects Claude Code, Codex, Gemini CLI, Cursor Agent, Copilot CLI, Aider, OpenCode plus your own . Only counts agents that are actually working , not sessions that are merely open. Clocks in when one starts working and hands over 5 minutes adjustable after everything goes quiet | | 🪖 Timed watch | 30 min / 1 h / 2 h / 4 h / indefinitely | | Watch modes | Keep display on caffeinate -d · Display may sleep, Mac stays awake caffeinate -i · Stay awake with the lid closed admin — all three sit right in the menu, one click to switch | | 🔋 Battery stand-down | Stands down when running on battery below your threshold default 20% , with one heads-up 5% before it. Plug in within 10 minutes and the same watch resumes a lid-closed watch asks for admin approval again | | | Restores normal lid sleep disablesleep back to off when the watch ends, the app quits, or the Mac restarts, shuts down or logs out. If it is still off when the app next starts after a power loss, say , that watch carries on as a system watch and the menu offers Restore lid sleep one admin password | | 🌡️ Heat advisory → 🔥 combat rest | Warns when the Mac heats up; when it gets critical, pauses the watch to cool down and resumes automatically once it cools no more cooking a closed Mac in a bag | | | If the sleep block disappears for any reason, it is re-engaged immediately | | 🕵️ Watchdog | In lid-closed mode, restores normal sleep within 5 s when the app quits or the watch ends including a timed watch running out , and at once when macOS stops it for a restart or shutdown — no second password prompt needed; re-enabling replaces rather than stacks it | | 📋 Night-watch handover | Come back after 10+ minutes away and get a report of what happened while you were gone | | 🔁 Survives restarts | Remaining watch time carries over app restarts, updates and reboots for security, a lid-closed watch comes back as a system watch for that watch only, also when lid sleep was left off; lid mode stays selected in the menu and asks for approval again on the next watch | | 🖥️ Who else is holding the Mac awake | The menu shows other apps blocking sleep, e.g. "Vivaldi video " | | 🌐 Korean / English / Simplified Chinese | Follows the system language by default; pick one from 언어 / Language / 语言 in the menu | | 📒 Duty log | ~/Library/Application Support/Bulchimbeon/duty-log.txt | Adrafinil https://github.com/kageroumado/adrafinil solves the same problem and came first. The two take opposite approaches, so pick the one that fits. As of October 2026. | | Bulchimbeon | Adrafinil | |---|---|---| | How it knows an agent is working | Watches from outside : the agent's caffeinate child and CPU use | The agent tells it : hooks acquire on prompt submit, release when the reply ends plus observation | | What installing changes | Nothing. One app; agent config files are never touched | Hooks added to agent configs one-click install/uninstall , a user daemon, a root helper | | macOS | 13 and later | 26.4 and later | | Awake with the lid closed | Admin password each time you turn it on; a watchdog guarantees the setting is restored | Approved once at install, no password afterwards | | Agent asks to stay awake long builds | — | CLI and MCP tool | | Heat | Warns even with the lid open; when it gets too hot, rests and resumes automatically once cool | Force-releases on overheating while the lid is closed | | Distribution | Developer ID signed and notarized from 0.12.6 , personal Homebrew tap | Notarized, official Homebrew cask | Choose Adrafinil if you're on macOS 26.4+ and want hooks to track turns precisely, or want agents to request wake time themselves. Choose Bulchimbeon if you're on macOS 13–15, don't want anything installed into your agent configs or system, or would rather have a private on watch. brew install --cask s3onghyun/tap/bulchimbeon Update — refresh the tap first, Homebrew's auto-update interval is long brew update && brew upgrade --cask bulchimbeon Or download the zip from Releases https://github.com/s3onghyun/bulchimbeon/releases and move it to /Applications . macOS 13+, universal Apple Silicon and Intel . First launch: macOS blocks the app once; the steps are in Start here start-here . Release zips are built only in GitHub Actions and carry a build provenance attestation. gh attestation verify Bulchimbeon-