Lockpaw: 화면은 가리고 AI는 계속
AI 코딩 에이전트에게 긴 작업을 맡기고 자리를 비웠다가, 권한 요청 화면에서 멈췄는지 확인하러 돌아온 경험이 있나요? 이런 반복을 줄이기 위해 만든 macOS 메뉴 막대 앱이 **Lockpaw**예요.
1. 화면만 가리고 작업은 계속하는 Lockpaw
Lockpaw는 Mac을 잠자기 상태로 전환하지 않고 화면만 가려주는 앱이에요. 단축키 한 번으로 화면을 덮을 수 있어, 자리를 비운 동안에도 Claude Code 같은 AI 에이전트는 계속 작업할 수 있습니다.
작업이 완료되거나 권한 요청(Permission Prompt)이 발생하면 가려진 화면이 빛납니다. 소리 대신 화면의 빛을 신호로 사용하기 때문에, 오픈 오피스나 조용한 공간에서도 주변 사람을 방해하지 않고 상태를 확인할 수 있어요.
다시 작업하려면 Touch ID로 잠금을 해제하면 됩니다. Mac 자체를 잠재우지 않으면서 화면 노출은 막고, 에이전트 상태까지 멀리서 확인할 수 있다는 점이 핵심이에요.
2. Claude Code 알림을 연결하는 방식
설치는 하나의 명령으로 완료되며, Claude Code의 훅(Hook)을 이용해 상태 변화를 전달해요. 훅은 특정 이벤트가 발생했을 때 미리 지정한 명령을 실행하는 자동화 기능입니다.
설정 명령을 실행하면 ~/.claude/settings.json에 다음 훅이 추가됩니다.
- Notification Hook: 권한 요청이나 유휴 상태(Idle Prompt)를 감지해요. 사용자의 확인이 필요한 순간을 놓치지 않는 데 유용합니다.
- Stop Hook: 에이전트가 작업을 마쳤을 때 실행돼요. 화면의 빛만 보고도 완료 여부를 알 수 있습니다.
lockpaw ping: 각 훅이 호출하는 간단한 명령으로, 앱에 상태 변화를 전달해요.
앱은 분산 알림(Distributed Notification)을 수신합니다. 따라서 Lockpaw가 실행 중이 아닐 때 ping 명령이 앱을 임의로 실행하지 않으며, 설정 파일을 수정하기 전에는 기존 파일을 자동으로 백업해 안전성도 확보했어요.
3. Claude뿐 아니라 다양한 AI 도구 지원
같은 설정 명령을 여러 AI 코딩 도구에 적용할 수 있다는 것도 장점이에요. Claude Code 전용 보조 앱에 머물지 않고, 개발자가 실제로 사용하는 다양한 에이전트 환경을 고려했습니다.
지원 대상에는 Codex, Gemini CLI, Cursor, Copilot CLI, Aider가 포함됩니다. 예를 들어 Gemini CLI로 리팩터링을 실행하거나 Aider에 테스트 수정을 맡긴 뒤 회의에 들어갈 때, 화면을 가려두고 상태 신호만 확인할 수 있어요.
여러 도구를 번갈아 사용하는 개발자라면 각각 별도의 알림 시스템을 구성할 필요가 없습니다. 화면 보호와 작업 상태 확인을 하나의 흐름으로 통합할 수 있다는 점이 실용적이에요.
4. Claude Code로 만든 네이티브 macOS 앱
흥미롭게도 Lockpaw의 상당 부분은 Claude Code 세션을 통해 개발됐어요. 특히 macOS 내부 동작과 관련된 까다로운 문제를 AI와 함께 해결했다는 점이 눈에 띕니다.
메뉴 막대 전용 앱에서는 Carbon 기반 단축키가 불안정할 수 있어, 백그라운드 스레드에서 CGEventTap을 사용하는 방식을 구현했습니다. 자동 업데이트 프레임워크인 Sparkle의 코드 서명도 내부 구성 요소부터 처리하는 순서로 정리했어요.
Touch ID 암호 입력 창이 표시된 상태에서 Cmd+Q가 앱까지 전달되는 버그도 있었습니다. macOS의 보안 입력(Secure Input)이 이벤트 탭에서 키 입력을 감춘다는 원인을 Claude Code가 찾아냈고, 종료 방지 로직을 작성한 뒤 개발자가 검토해 배포했어요.
5. 작고 투명한 오픈소스 도구
Lockpaw는 네이티브 Swift로 개발됐으며 용량은 약 10MB예요. 분석 도구나 사용자 추적 기능을 넣지 않았고, MIT 라이선스로 무료 공개된 오픈소스 프로젝트입니다.
저장소의 CLAUDE.md에는 기술적 결정과 해결 과정이 기록돼 있습니다. 덕분에 새로운 Claude Code 세션을 시작해도 이전 세션의 맥락을 이어받아 개발을 계속할 수 있어요.
커뮤니티 기여도 이어졌습니다. 한 사용자는 OLED 패널의 번인 위험을 줄이기 위해 몇 분 후 화면을 완전한 검은색으로 전환하는 페이드 기능을 PR(Pull Request)로 추가했어요.
마무리하며
Lockpaw는 AI 에이전트를 더 빠르게 만드는 도구라기보다, 에이전트를 기다리고 확인하는 사람의 불편을 줄이는 도구에 가깝습니다. 화면을 노출한 채 자리를 비우거나, 작업 상태를 확인하려고 계속 책상으로 돌아오는 사용자에게 특히 유용해요.
평소 AI 코딩 에이전트에 긴 작업을 맡긴다면, 지금 어떤 방식으로 완료와 권한 요청을 확인하고 있는지 돌아볼 만합니다. 작은 상태 알림 하나가 개발 흐름을 예상보다 훨씬 매끄럽게 바꿔줄 수 있어요.
