Repolode
Submit
s3onghyun

s3onghyun/bulchimbeon

A macOS menu bar app that keeps your Mac awake only while AI coding agents like Claude Code or Codex are actively working.

Open-source alternative to:Amphetamine

View on GitHub
Stars
56
Forks
7
Open issues
15
Last commit
yesterday

What is it?

Bulchimbeon is a macOS menu bar app for people who run long AI coding agent sessions and don't want the Mac to sleep mid-task. It watches local processes for supported agents such as Claude Code, Codex, Gemini CLI, Cursor Agent, Copilot CLI, Aider and OpenCode, and holds a sleep lock only while one is working. When the agent goes quiet, the lock is released after a configurable grace period, so the Mac can sleep normally again without manual steps.

The app offers timed watches, a display-on or display-may-sleep mode, and an optional lid-closed mode that requires an administrator password. It stands down when on battery below a set threshold, warns about heat and pauses until the Mac cools, and restores normal lid sleep when the watch ends or the app quits. It runs on macOS 13 and later, and a Go-based Linux daemon with a tray icon uses the same detection logic.

Agent detection uses process names, install paths and CPU usage rather than hooks or config changes, so nothing is added to agent configuration files. Installation is through Homebrew or a release zip, and the app is ad-hoc signed and not yet notarized.

Key features

  • 01Detects supported AI coding agents and keeps the Mac awake only while they are working
  • 02Timed watches, display-on or display-may-sleep modes, and optional lid-closed operation
  • 03Stands down on low battery and pauses during overheating, resuming once cool
  • 04Restores normal lid sleep when the watch ends or the app quits
  • 05Linux daemon with command line and tray icon using the same detection rules
  • 06Lets you add custom agent process names

Use cases

  • Leaving a coding agent running overnight without leaving caffeinate on afterward
  • Keeping a laptop awake during long builds or tests triggered by an agent
  • Running an agent with the lid closed while on power, with the lid mode restored automatically afterward

Quick start

  1. 1

    Install the app with Homebrew

    brew install --cask s3onghyun/tap/bulchimbeon
  2. 2

    Open the app once, then allow it in System Settings → Privacy & Security → Open Anyway

  3. 3

    On Linux, install the daemon with Homebrew and start it as a user service

    brew install s3onghyun/tap/bulchimbeon-linux && brew services start bulchimbeon-linux

Things to know

  • The macOS app requires macOS 13 or later, and the Linux daemon requires systemd and logind.
  • The app is ad-hoc signed and not yet notarized, so macOS blocks it on first launch.
  • Lid-closed mode requires an administrator password each time it is turned on.
  • Agents running in Docker or on a remote host over SSH are not detected.

In collections

macOS menu bar appsClaude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agentsOpen-source Mac apps

Topics

#macos#menu-bar-app#ai-agents#claude-code#sleep-prevention#keep-awake#coding-agents#developer-tools#amphetamine#caffeinate

FAQ

What is bulchimbeon?
A macOS menu bar app that keeps your Mac awake only while AI coding agents like Claude Code or Codex are actively working. Bulchimbeon is a macOS menu bar app for people who run long AI coding agent sessions and don't want the Mac to sleep mid-task. It watches local processes for supported agents such as Claude Code, Codex, Gemini CLI, Cursor Agent, Copilot CLI, Aider and OpenCode, and holds a sleep lock only while one is working. When the agent goes quiet, the lock is released after a configurable grace period, so the Mac can sleep normally again without manual steps.
Is bulchimbeon free to use? What license does it have?
bulchimbeon is open source under the MIT license. Check the license terms before using it in commercial products.
Is bulchimbeon still maintained?
Actively maintained. The last commit to bulchimbeon was on Nov 6, 2026.
What can I use bulchimbeon for?
Leaving a coding agent running overnight without leaving caffeinate on afterward Keeping a laptop awake during long builds or tests triggered by an agent Running an agent with the lid closed while on power, with the lid mode restored automatically afterward
How do I install bulchimbeon?
Install the app with Homebrew: brew install --cask s3onghyun/tap/bulchimbeon Open the app once, then allow it in System Settings → Privacy & Security → Open Anyway On Linux, install the daemon with Homebrew and start it as a user service: brew install s3onghyun/tap/bulchimbeon-linux && brew services start bulchimbeon-linux
Where can I get bulchimbeon?
The source code and installation instructions are on GitHub: https://github.com/s3onghyun/bulchimbeon

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects