Show GN: claude-bulkhead: PC에서 병렬로 돌리는 Claude Code 세션들의 프로세스, 포트, 메모리 충돌을 막는 플...

Claude Code 세션 여러 개를 git worktree별로 나누어 한 PC에서 동시에 실행하고 있습니다. 이 환경에서 같은 문제가 반복되었습니다. 한 에이전트가 정리 작업 중에 taskkill /F /IM node.exe를 실행하면 다른 세션에서 실행 중이던 개발 서버와 테스트가 모두 종료되었습니다. 세 세션이 동시에 빌드를 시작했을 때는 메모리가 부족해 PC가 멈추었고 강제로 재부팅해야 했습니다.

claude-bulkhead는 이 문제를 막기 위해 만든 Claude Code 플러그인입니다. 세션이 셸 명령을 실행하기 직전에 다른 세션이 사용 중인 프로세스와 포트를 확인하고 남은 메모리를 확인합니다. 다른 세션에 영향을 주는 명령은 실행 전에 차단하고 대신 실행할 명령을 Claude에게 안내합니다.

차단하는 명령은 다음과 같습니다.

• 프로그램 이름으로 프로세스를 종료하는 명령 (pkill node, taskkill /IM node.exe)
• 다른 세션이 사용 중인 포트로 개발 서버를 실행하는 명령
• 남은 메모리가 부족할 때 시작하는 빌드와 테스트
• 다른 세션이 작업 중인 폴더에서 실행하는 git checkout과 git reset

세션이 종료된 뒤에 남은 개발 서버와 테스트 프로세스는 몇 초 안에 자동으로 정리합니다.

선택 기능으로 bulkhead remote를 제공합니다. 무거운 작업을 SSH로 다른 PC에 보내 실행하는 기능입니다. 변경된 커밋과 파일만 전송하며 작업이 끝나면 원격 PC에서 실행한 프로세스를 모두 종료합니다.

잘못 차단되는 명령이나 개선할 점은 이슈 남겨 주시면 반영하겠습니다.