kunchenguid/gnhf

해결하는 문제

gnhf (Good Night, Have Fun)는 사용자가 떠나 있을 때도 AI 코딩 에이전트가 자동으로 지속적으로 실행되도록 설계된 자율 오케스트레이터입니다. 수동 감시의 문제를 해결하기 위해 특정 목표를 향해 작은, 커밋된, 문서화된 변경 사항의 루프를 자동화하여 사용자가 깨어났을 때 멈춘 프로세스가 아니라 깔끔하고 단계적인 작업이 완료된 브랜치를 확인할 수 있도록 보장합니다.

작동 방식

이 도구는 비대화형 코딩 에이전트를 호출하는 루프로 작동합니다. 각 반복마다 다음을 수행합니다:

1. 실행: 에이전트에게 변경 사항을 수행하도록 트리거합니다.
2. 검증: 변경 사항이 성공하면 별도의 git 커밋을 생성하고, notes.md 파일에 메모를 추가하여 반복 간 공유 메모리 역할을 합니다.
3. 실패 처리: 반복이 실패한 경우 git reset --hard로 변경 사항을 되돌립니다. 다만 커밋 실패의 경우 다음 반복에서 복구할 수 있도록 작업을 보존합니다.
4. 지속성: .gnhf/runs/ 디렉터리를 사용해 프롬프트, 로그, 메타데이터를 저장하여 나중에 실행을 재개할 수 있도록 합니다.
5. 레이트 제한 관리: Claude 등에서 발생하는 레이트 제한을 자동 감지하고, 재설정 시간이 지나기 전까지 대기한 후 실행을 재개합니다.

대상 사용자

AI 코딩 에이전트를 사용하고 있으며, 리팩터링이나 기능 구현과 같은 장시간 작업을 실시간으로 각 단계를 수동으로 트리거하거나 변경 사항을 검토하지 않고 수행하고 싶은 개발자들입니다.

주요 기능

• 단계적 커밋: 모든 성공적인 단계가 별도로 커밋되어 쉽게 체리피킹 또는 롤백이 가능합니다.
• 에이전트 독립성: 다양한 코딩 에이전트 CLI 및 ACP 타겟과 호환됩니다.
• 워크트리 모드: 격리된 git 워크트리로 동일한 리포지토리에서 여러 에이전트를 동시에 실행할 수 있습니다.
• 실행 제한: 최대 반복 수, 총 토큰 수, 사용자 정의 정지 조건(--stop-when)을 설정할 수 있습니다.
• 실시간 상태: 토큰 총합과 커밋 수를 실시간으로 터미널 제목에 업데이트합니다.