kunchenguid/gnhf

Before I go to bed, I tell my agents: good night, have fun

해결하는 문제

gnhf는 코딩 에이전트를 위한 자율 오케스트레이터로, 사람이 지속적으로 감독하지 않아도 밤새도록 코드베이스에서 작업할 수 있게 해줍니다. 이 도구는 에이전트가 한 번에 위험한 큰 변화를 시도하는 대신, 목표를 향해 작고 커밋 가능하며 문서화된 점진적 변경을 수행하도록 보장함으로써 "빈손으로" 깨어나는 문제를 해결합니다.

작동 방식

이 도구는 기존 코딩 에이전트 CLI를 루프로 감쌉니다. 각 반복마다 다음을 수행합니다:

  1. 에이전트 프롬프트: 목표와 notes.md 파일(반복 간 공유 메모리 역할)을 주입합니다.
  2. 실행: 에이전트를 비대화형 모드로 실행합니다.
  3. 검증 및 커밋: 에이전트가 성공하면 gnhf는 git 커밋을 생성하고 메모에 내용을 추가합니다. 실패하면 git reset --hard를 사용하여 변경 사항을 롤백합니다(커밋 실패인 경우는 복구를 위해 유지합니다).
  4. 제한 관리: API 사용량 제한(예: Claude의 사용량 윈도우)을 자동으로 관리하여 재설정 시간까지 기다린 후 작업을 재개합니다.
  5. 상태 관리: 전용 gnhf/ 브랜치, 현재 브랜치 또는 격리된 git 워크트리에서 실행할 수 있어 여러 에이전트가 동일한 저장소에서 동시에 작업할 수 있습니다.

대상 사용자

AI 코딩 에이전트를 사용하며 몇 분마다 터미널을 모니터링할 필요 없이 장시간 실행되는 리팩토링, 기능 구현 또는 코드베이스 정리를 자동화하려는 개발자.

주요 특징

  • 에이전트 독립적: 널리 사용되는 코딩 에이전트 CLI 및 모든 ACP 대상과 작동합니다.
  • 점진적 진행: 성공한 모든 단계는 git에 커밋되므로 쉽게 체리 픽(cherry-pick)하거나 되돌릴 수 있습니다.
  • 워크트리 지원: 격리된 디렉토리에서 동일한 저장소에 여러 에이전트를 동시에 실행합니다.
  • 스마트한 제한 처리: API 사용량 윈도우 동안 자동으로 대기하고 작업을 재개합니다.
  • 재개 기능: 중단된 경우 기존 브랜치에서 이전 실행을 이어서 수행할 수 있습니다.

관련

  • 프로젝트
    viettran-edgeAI/codex_workflow

    codex_workflow는 Codex AI 어시스턴트용 Python 기반 애드온으로, 세 가지 실행 모드(라이트, 미디엄, 헤비)를 도입합니다. 프로젝트 목표, 결정 및 진행 상황을 저장하는 영구적인 `agent_docs/` 폴더를 자동으로 생성하고, 전문 하위 에이전트(Explorer, Investigator, Executor, Tester, Archivist)를 생성하여 작업을 공유하고 메인 에이전트의 토큰 사용량을 줄일 수 있습니다. 설치는 수동 zip 다운로드와 부트스트랩 스크립트로 이루어집니다. 사용법은 Codex 채팅에서 `use medium route. <작업>`을 입력하는 것만큼 간단합니다. 이 도구에는 토큰 사용량 보고와 배치 처리 휴리스틱이 비용을 절감하는 방법을 보여주는 벤치마크가 포함되어 있지만, Codex의 세션당 4개 에이전트 제한과 수동 업데이트 요구 사항이 한계입니다.

  • 프로젝트
    Intelligent-Internet/zenith

    Zenith는 Claude Code, Codex 또는 Hermes를 장기 실행 가능한 코드 에이전트로 작동시키는 Python 기반 하드웨어입니다. 오케스트레이터는 프로젝트 상태를 반복적으로 확인하고, 워커/테스터 하위 에이전트를 생성하며, 재사용 가능한 스킬을 등록하고, 작업을 재계획하며, 작업이 진정으로 완료될 때까지 중지하지 않습니다. Frontier SWE 벤치마크에서 GPT-5.5를 사용한 Zenith는 가장 낮은 평균 순위를 기록했으며, 가장 강력한 베이스라인(RALPH)보다 비용의 절반 미만으로 운영되었습니다. 리포지토리는 CLI, MCP 서버, ACP 어댑터 및 완전한 기술 보고서를 포함합니다.

  • 프로젝트
    maddada/Ghostex

    Ghostex는 여러 AI 코딩 에이전트를 관리하기 위한 크로스 플랫폼 워크스페이스로, 채팅, 터미널 액세스 및 IDE 통합을 위한 통합 인터페이스를 제공하며 세션과 기기 간의 지속성을 지원합니다.

  • Dispatch
    TITLE: Hugging Face hf CLI 에이전트‑최적화 재설계, 토큰 사용량을 절감하고 성공률을 높인다

    SUMMARY: Hugging Face는 hf CLI의 에이전트‑최적화 재설계를 발표했으며, 토큰 사용량을 최대 6배 절감하고 Claude Code와 Codex와 같은 코딩 에이전트의 성공률을 향상시킵니다.

  • 프로젝트
    HangYu8123/HarnessFlow

    HarnessFlow는 Claude Code, Codex CLI, 또는 GitHub Copilot을 다단계로 자가 검토 가능한 코딩 어시스턴트로 바꾸는 포터블 Markdown 지침 파일 세트입니다. 리퀘스트 템플릿, 병렬 분석 에이전트, 악마의 변호사 도전, QA 검증, 지속적인 리포지토리 메모리를 제공합니다. 리포지토리의 `.github/HarnessFlow/`에 팩을 복사하고 제공된 `setup.sh` 또는 `cli_setup.sh`를 실행하여 설치할 수 있습니다. 리퀘스트 템플릿(코드, 리팩터링, 디버깅 등)을 선택하고 채운 후 어시스턴트에 붙여넣습니다. 이 팩은 `general`, `fast`, `skill` 세 가지 워크플로우 모드를 지원하며, 벤치마크 결과로 생성 코드 줄 수가 최대 76% 감소하면서도 100% 정확성을 유지했습니다.