개요
Capsomnia는 Caps Lock 키를 “잠자기 방지” 물리 스위치로 바꾸는 작은 macOS 앱이다(macOS 14 이상, Swift, MIT 라이선스). Caps Lock을 켜고 맥북 뚜껑을 닫아도 로컬 작업이 계속 돌아간다. 키보드의 Caps Lock LED가 켜져 있으면 잠자기 방지 상태라서, 메뉴 바를 보지 않고도 상태를 확인할 수 있다.
v1.0.0은 2026-07-12(KST)에 나왔다. 2026-10-04 확인 기준으로 GitHub 별 420개이고, 사이트는 X 조회 250만 회 이상과 다운로드 1만 회 이상을 내세운다.
동작 원리
| Caps Lock | 실행 명령 | 결과 |
|---|---|---|
| 켬 | pmset -a disablesleep 1 | 시스템 잠자기 비활성화 |
| 끔 | pmset -a disablesleep 0 | 평소 잠자기 동작으로 복귀 |
caffeinate와 달리 disablesleep은 뚜껑을 닫았을 때의 잠자기까지 막는다. 이 차이 때문에 클램쉘 상태에서도 작업이 이어진다.
쓰임새
- AI 에이전트: codex나 Claude Code에 긴 작업을 맡기고 뚜껑을 닫아 둔다. 장시간 에이전트 운용은 2026-05-05-long-running-agents 참고
- SSH 원격 접속: 원격 로그인과 네트워크가 살아 있으면 세션 도중 맥이 잠들지 않는다.
- 빌드·다운로드: 긴 컴파일이나 대용량 다운로드를 끝까지 돌린다.
- 모바일 연결: Codex Mobile 같은 모바일 세션이 끊기지 않게 한다.
주요 기능
- 자동 해제 타이머: 15분
8시간 프리셋이나 1분24시간 사용자 지정 시간을 고를 수 있다. 시간이 끝나면 잠자기 방지를 풀고,SleepDisabled=0이 확인되면 맥을 재운다. - 사용자 지정 단축키: Caps Lock을 다른 용도로 쓰고 있다면 원하는 단축키로 켜고 끌 수 있다. 켜져 있는 동안에는 Caps Lock 표시등이 계속 켜진다.
- 앱을 종료하면 평소 잠자기 동작이 복구된다.
보안 모델
- 메뉴 바 앱은 현재 사용자 권한으로 실행되며 root로 돌지 않는다.
- 잠자기 설정 변경에는 관리자 권한이 필요하다. 그래서 root 소유의 작은 고정 헬퍼(
/Library/PrivilegedHelperTools/capsomnia-pmset)를 비밀번호 없는sudo로 호출한다. sudoers 규칙은on·off·display-sleep세 명령으로만 제한된다. - 헬퍼가 실행하는 명령은
pmset -a disablesleep 1|0과pmset displaysleepnow셋뿐이다. - 네트워크 요청, 텔레메트리, 계정이 전혀 없다.
주의
뚜껑을 닫은 채 잠자기를 막으면 발열과 배터리 소모가 늘어난다. 통풍과 전원, 실행 시간을 신경 써야 한다.
링크
- 다운로드: Capsomnia.pkg (최신 릴리스)
- GitHub: https://github.com/fuji-mak/Capsomnia
- 비슷한 맥 보조 도구: 2026-07-08-pytorchkr-topic-11116-codeisland-macos-notch-ai-agent-status(노치에 에이전트 상태 표시)