제가 만든 Claude Code 플러그인입니다.
Flutter 앱을 Claude Code로 개발하면서 가장 비싼 실패는 틀린 코드가 아니라 "기다림"이었습니다. 하루 동안 실제로 겪은 것들:
- Marionette MCP connect가 10분 넘게 매달림 (MCP 호출은 Bash 타임아웃 밖. stdio MCP 기본 유휴 한도는 30분)
- 배포 후 폴링 루프가 3분에 끝났는데 Claude는 15분도 더 지나서야 알려줌
- 백그라운드 flutter run이 타임아웃으로 죽었는데 아무도 모름
- 서브에이전트 하나가 1시간가량 멈춘 채 있었음
- 세션 두 개가 같은 폰에 동시에 빌드해서 둘 다 실패
개별 도구 버그가 아니라 "한도가 없고, 끝나도 보고가 없다"는 공통 원인이라서, 훅으로 묶었습니다.
■ anti-stuck (코어)
- 모든 Bash 호출에 하드 시간 제한(기본 300초). 더 긴 명령은 첫 줄에
# eta:<초>
를 선언해야 하고 한도는 min(등록값, eta×2) - 루프를 통째로 멈추게 하는 것 거부: --max-time 없는 curl, --cli-read-timeout 없는 aws, gh --watch, sleep 60 이상, 끝이 안 보이는 while/until
- 60초 넘은 호출·대기 루프·kill·서브에이전트가 끝나면 "다음 답변 첫 줄에 결과 보고" 강제
- 백그라운드 Bash/Agent 작업 장부: 끝났거나 기한 넘긴 항목을 매 도구 호출마다 되밀어 주고, 보고 안 한 채 세션을 끝내려 하면 한 번 막음
- 서브에이전트 시간 예산(기본 10분). 넘기면 도구가 거부되어 보고하고 끝남
■ anti-stuck-flutter (Flutter 팩)
- 세션끼리 실기기·에뮬레이터·무거운 빌드를 공유하는 장부. 기기 하나에 주인 하나, 무거운 빌드는 한 번에 하나
- 기기가 비면 대기 중인 세션을 즉시 깨움
- Marionette MCP 호출 전 앱 VM 응답 확인(3초), 안 되면 바로 실패
설치:
claude plugin marketplace add toyaji/anti-stuck
claude plugin install anti-stuck@anti-stuck
MIT, macOS/Linux. 데몬·네트워크 없음, 각 플러그인 README에 무엇을 실행·읽기·쓰기·kill하는지 전부 적었습니다.
받고 싶은 피드백:
- 여러분이 겪은 "멈춤" 사례 (docs/stuck-cases.md에 모으고 있습니다 — 어디서, 얼마나, 왜 아무도 몰랐는지)
- Xcode / Gradle / Docker / Node 팩 — JSON 세 파일이면 됩니다
알려진 한계: 규칙이 명령 텍스트를 읽어서 특이한 인용에 오탐 가능, 훅 자체가 타임아웃되면 Claude Code가 도구를 통과시키므로 훅은 빠른 검사만, Windows 미지원.