원문 캡처 · github.com
원문 캡처 · github.com

Hooke는 systemd 데몬으로 파일 변경을 감시하거나 정해진 주기에 따라 작업을 실행하고, 각 작업을 프로젝트 맥락과 설정된 MCP 서버를 이용하는 에이전트 세션에 맡긴다. Python 3.14 이상과 pi 또는 PATH에 등록된 지원 에이전트가 필요하다.

프로젝트 디렉터리에서 hooke init을 실행해 hooke.toml 설정 파일을 만들고, 작업 프롬프트와 일정 또는 감시할 경로를 지정한다. 자동화마다 에이전트와 모델, 사용할 MCP 서버, 시간 제한, 재시작 후 재실행 여부, 세션 이어쓰기 등을 설정할 수 있다. 준비된 예시는 저장소의 examples 디렉터리에서 확인할 수 있다.

hooke deploy는 설정 파일과 스키마 버전, 경로 패턴, MCP 서버 존재 여부, 프로젝트 신뢰 설정을 검증한 뒤 데몬의 등록 정보를 갱신한다. 설정이 잘못되면 배포 단계에서 오류를 알린다. 변경 없는 재배포는 아무 작업도 하지 않으며, 설정을 바꿔도 변경되지 않은 자동화의 타이머는 초기화하지 않는다고 저장소는 설명한다.

데몬은 systemd에 설치해 실행한다. 현재 로드맵에는 PyPI 배포, 데몬 시작 시 감시 경로를 한 번 검사하는 기능, 수동 실행 명령, 실패·시간 초과 알림이 포함돼 있다. 따라서 감시 기능은 지금은 데몬이 시작될 때가 아니라 다음 파일 변경이 일어날 때 실행된다.

설치와 설정 방법은 Hooke 저장소에서 확인할 수 있다.