fuji-mak/Capsomnia

Current version: 4.3.4
日本語 README · 简体中文 README · 한국어 README
Capsomnia is a small macOS menu bar app that turns Caps Lock into a physical keep-awake switch for closed-lid MacBook work.
Turn Caps Lock on when local work should keep running. Turn Caps Lock off when you want normal sleep behavior back.
Capsomnia responds faster to Caps Lock key presses and handles rapid switches between Japanese and English input more reliably.
It is useful for AI agents, mobile access, and other long-running or remote work.
Capsomnia does not collect telemetry or require an account. Network use is limited to an optional daily update check that reads GitHub's public release information (off switch in Advanced Settings), downloading installers from GitHub when you choose to update or install CLI & Skill, and local gateway probes when "Keep hotspot connected" is enabled. Capsomnia sends no telemetry, identifiers, or personal data.
When “Use Computer Use and similar tools” is enabled, an optional “Lock when lid opens” checkbox appears beneath it. It is off by default and locks the Mac after a closed-to-open lid transition is detected while Capsomnia is on. The settings header indicator shows confirmed ON in glowing green, OFF in gray, and failure or unknown state in red. Lid-open locking is detected after opening; it does not guarantee that screen contents are never briefly visible.
When this tiny light is on, your Mac stays awake.
## Quick Start
Requirements:
Signed upstream package: Apple silicon Mac with macOS 14 or later
Source install: Apple silicon Mac with macOS 14 or later, or Intel Mac with macOS 13.5 or later
Administrator access during installation
Install the signed package:
1. Download Capsomnia.pkg from GitHub Releases.
2. Open the package and follow the installer.
Release packages are signed with Developer ID and notarized by Apple. The package installs Capsomnia.app in /Applications, installs the signed native privileged sleep-control helper, adds a narrow sudoers rule, and starts the LaunchAgent. Capsomnia opens after installation and starts automatically at login afterward.
The package build and install scripts are public in scripts/build-pkg.sh and scripts/notarize-pkg.sh.
## CLI & Skill
In Advanced Settings → Download Capsomnia CLI & Skill, confirm Install in the dialog to add both tools.
Capsomnia downloads the package and installs it after macOS authentication,
then shows a completion dialog. There are no agent or folder choices. The app's own package
contains only the app and its helper; Capsomnia-Tools.pkg, published in the cpsm
repository, adds the optional tools.
cpsm: Capsomnia CLI and common capsomnia
Skill. Requires this app; one-shot timers and explicit off include sleep.
MacReady: independent read-only Mac
state CLI and macready Skill. Does not require the app.
The app downloads the signed and notarized Tools package from the cpsm GitHub release.
Skills are shared in ~/.agents/skills/, with automatic Claude Code links.
Normal CLI usage stays local. Distribution and compatibility.
## Build From Source
Developer source installation supports Apple silicon Macs on macOS 14 or later and Intel Macs on macOS 13.5 or later. It requires Swift 5.9 or later, included with Xcode 15 or later: