Diaktoros는 Hermes에서 풀 리퀘스트(PR)를 검토하고 발견된 문제를 수정하는 작업을 제한적으로 자동화하는 플러그인이다. 새 이슈 분류와 소규모 수정, CI 실패 전달, 정체 감시 등을 지원하지만 자동으로 병합하지는 않는다. GitHub 저장소
검토 에이전트와 수정 에이전트가 역할을 나눠 작업하며, 분쟁은 판정 담당자에게 넘긴다. Python 기반 제어 로직이 작업 자격, 처리 용량, 재시도와 에스컬레이션을 관리하고, 작업 횟수에는 상한을 둔다. 주요 명령과 전체 기능은 명령어 문서와 문서 안내에서 확인할 수 있다.
설치하려면 Linux와 작동하는 bubblewrap(bwrap), 비특권 사용자 네임스페이스가 필요하다. 기본 환경은 Hermes 0.21.5 이상, Hermes Git 체크아웃과 가상환경, Python 런타임, Rust 도구 체인이다. 네이티브 macOS 작업은 지원하지 않으며 Hermes와 플러그인을 Linux 안에서 실행해야 한다. 버전만으로 샌드박스와 제공자 호환성을 확인할 수 없으므로 설치 뒤 selftest를 실행하도록 안내한다. 또한 HTTPS로 연결할 수 있는 Hermes 게이트웨이와 관리 권한이 있는 저장소, 검토·수정용으로 서로 다른 Hermes 프로필이 필요하다. GitHub 토큰은 읽기·검토·수정 역할에 각각 별도로 준비해야 한다. 자세한 계정 조건은 계정과 권한 안내, Hermes 설정은 Hermes 문서를 참고하면 된다.
카탈로그에서 설치하는 기본 명령은 다음과 같다. 저장소에서 직접 설치하면 현재 main을 가져오며 설치 경고를 확인하고 진행 여부를 선택해야 한다. 제작자는 카탈로그 설치가 검토된 커밋으로 고정된다고 설명한다. 설치 스캐너는 플러그인을 ‘주의’로 분류하지만, 제작자는 이 판정이 보안 감사는 아니라고 밝힌다.
hermes plugins install diaktoros
hermes dk setup --repo "<owner>/<repository>"
setup은 런타임 경로를 찾고 설정을 미리 본 뒤 요청된 연결을 설치하며, 감시 작업을 예약하고 doctor와 selftest --no-model을 실행한다. 활성화 전 확인을 요청하므로 준비가 끝날 때까지 활성화를 미룰 수 있다. 훅을 직접 만들 계획이라면 관리자 이름을 입력하지 않은 상태에서 설정이 중단될 수 있으며, 이는 훅을 수동으로 만든 뒤 진행하도록 의도된 동작이다. 시작 안내에는 비대화형 설정과 명시적 초기화 방법이 담겨 있다.
안전 경계에도 유의해야 한다. 에이전트는 GitHub·모델 자격 증명과 직접 네트워크 접근 없이 bubblewrap에서 실행되고, 호스트 프로세스가 제한된 추론과 외부 쓰기를 중개한다. 수정 에이전트의 자동 푸시는 기본적으로 꺼져 있으며, 운영자가 별도 명령으로 명시적으로 활성화해야 한다. PR은 최종 API 확인과 푸시 사이에 닫히거나 대상 브랜치가 바뀔 수 있어, Git 참조 잠금만으로 GitHub의 PR 정보를 원자적으로 보장할 수 없다. 어떤 작업 좌석도 병합 권한을 갖지 않으며, 결과가 불확실한 쓰기는 자동 재실행하지 않는다. 설치된 플러그인은 호스트 코드로 신뢰해야 하고, 커널이나 bubblewrap 탈출이 발생하면 호스트 사용자 권한으로 실행될 수 있다. 보안 경계와 푸시 정책
이슈 분류·수정과 데스크톱 화면 렌더링은 오프라인 테스트 범위이며, 제작자는 이를 실제 환경에서의 승인 테스트로 주장하지 않는다. 실험적 Claude 구독 연동도 제공되지만, 네이티브 인증은 기본적으로 호스트 사용자의 로그인에 의존하고 오프라인 테스트만으로 실제 실행을 입증하지 않는다. 설정 문서와 개발 안내에서 관련 조건을 확인할 수 있다.
추가로 문제 해결 안내, 운영 문서, 개념 설명, 이슈 처리 설정, 옵서버 알림, 설정 항목을 제공한다. 라이선스는 MIT다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요