unsnooze - AI 코딩 세션 사용량 제한이 풀리면 자동으로 깨워주는 도구
unsnooze - wakes your AI coding sessions up when the usage limit resets
핵심 요약
Claude Code 사용량 제한으로 세션이 멈췄을 때, 제한 해제 시점에 맞춰 자동으로 세션을 재개해 주는 오픈소스 도구입니다.
- 자동 세션 재개 — 사용량 제한 해제 시점에 맞춰 멈춘 세션을 자동으로 다시 시작함
- 다양한 환경 지원 — tmux 세션, VS Code 확장 프로그램, 데스크톱 앱 등과 호환됨
- 오픈소스 공개 — MIT 라이선스이며 텔레메트리나 계정 연동 없이 사용 가능함
- 피드백 수집 — 지원되지 않는 제한 메시지 발견 시 리포트 명령어로 추가 지원 가능함
Claude Code로 긴 작업을 할 때마다 똑같은 문제에 부딪혔습니다.
자기 전에 대규모 리팩토링을 걸어두면, 몇 시간 뒤 사용량 제한 때문에 작업이 멈춰 있는 걸 발견하곤 했습니다. 제한은 몇 시간 뒤에 풀리지만, 제가 깨어날 때까지 컴퓨터는 아무것도 안 하고 그냥 멈춰 있었죠.
한동안은 새벽에 알람을 맞춰놓고 엔터 키를 누르기도 했습니다. 이건 딱히 지속 가능한 방법이 아니었죠.
그래서 저를 위해 unsnooze라는 작은 도구를 급하게 만들었습니다.
이 도구는 tmux에서 실행 중인 Claude Code/Codex 세션을 감시합니다. 사용량 제한으로 세션이 멈추면, 어떤 세션인지 그리고 언제 제한이 풀리는지(배너를 읽어서) 기록합니다. 제한 해제 시간이 되면 자동으로 세션을 재개합니다. 터미널이 열려 있으면 같은 창에서 계속 진행하고, 닫혀 있으면 세션을 다시 열어 거기서 재개합니다.
GIF는 실제 녹화 영상입니다. 데모가 5시간씩 걸리지 않게 제한 시간을 1분으로 바꿨을 뿐, 실제 작동 방식은 영상과 똑같습니다.
Claude Code와 Codex CLI에서 작동합니다. 터미널을 모니터링할 수 없는 VS Code 확장 프로그램이나 데스크톱 앱에서 시작된 세션도 지원하도록 추가했습니다. 실험적인 Grok 지원도 포함되어 있는데, Grok의 제한 메시지는 일관성이 좀 떨어지긴 합니다.
제한을 우회하거나 자동화하려는 게 아닙니다. 그저 공식적인 제한 해제를 기다렸다가, 제가 직접 일어나서 해야 할 일을 대신 해줄 뿐입니다.
다른 분들에게도 유용할 것 같아서 정리해서 오픈소스로 공개했습니다.
MIT 라이선스이며, 텔레메트리나 계정은 없습니다.
Repo: https://github.com/saaranshM/unsnooze
혹시 사용해 보시고 감지되지 않는 제한 메시지를 발견하시면, unsnooze report 명령어로 배너를 캡처해 주세요. 그럼 제가 지원을 추가할 수 있습니다.
