새벽 2시에 '사용량 제한' 때문에 깨는 게 지겨워서, 알아서 대기하고 작업을 이어가는 도구를 만들었습니다
I got tired of waking up to "usage limit reached" at 2 AM, so I built a thing that waits it out and carries on
핵심 요약
Claude Code 등 AI 에이전트의 사용량 제한을 자동으로 관리하고 텔레그램으로 제어하는 오픈소스 도구 'nightmux'를 개발했습니다.
- 자동 작업 재개 — 사용량 제한 시 리셋 시간을 감지해 대기 후 작업을 자동으로 이어감
- 텔레그램 제어 — 승인 메뉴와 테스트 결과를 폰으로 확인하고 원격으로 제어 가능
- 멀티 에이전트 지원 — Claude Code, Gemini CLI 등 다양한 에이전트와 연동 및 실패 시 페일오버 지원
- 간편한 설치 — 표준 라이브러리만 사용하는 파이썬 파일 하나로 구성된 자가 호스팅 도구
자기 전에 Claude Code로 큰 작업들 큐에 넣어두잖아. 근데 자고 일어나면 십중팔구 새벽 2시에 5시간 제한 걸려서 6시간 동안 그냥 놀고 있더라.
그래서 nightmux를 만들었음. tmux 안에서 Claude Code(랑 Codex, Gemini CLI, OpenCode, Aider 등등)를 돌리고 텔레그램으로 조종하는 놈임:
- 사용량 제한 걸리면 메시지에서 초기화 시간 읽어와서, 큐랑 끊긴 작업 내용 그대로 들고 있다가 창 열리는 순간 바로 `continue` 날려줌. 아니면 `!failover codex` 써서 다른 에이전트한테 일 떠넘길 수도 있고.
- 승인 메뉴가 폰에 버튼으로 뜨니까 침대에서 탭 한 번이면 "yes" 끝임.
- `!goal npm test` 쓰면 턴마다 테스트 다시 돌리고, 통과할 때까지 에러 내용 피드백 넣어줌.
- `!po <goal>` 치면 리포지토리 분석해서 로드맵 짜주는데, 승인 누르면 각 항목마다 에이전트랑 워크트리 하나씩 할당됨.
- 아침에 일어나면 뭐 끝냈는지, 어떤 PR이 준비됐는지 브리핑 딱 받음.
파이썬 파일 하나짜리고, 표준 라이브러리만 쓰고, 셀프 호스팅 가능하고, MIT 라이선스임. 텔레메트리 같은 거 없음.
봇 없이 써보려면 `python3 nightmux.py --demo` 돌려보거나, README에 있는 라이브 데모 확인하셈.
https://github.com/mmr710/nightmux
궁금한 거 있으면 다 물어봐. 혹시 Remote Control이나 Happy 쓰고 있는 사람들은 그거 세션 하나 관리할 땐 좋은데, 이건 "밤새 에이전트 여러 개 돌리는" 용도임. README에 솔직하게 비교표도 넣어놨으니까 참고하고.
