Skip to main content
memory/heartbeat-state.json은 AI가 마지막으로 각 작업을 체크한 시간을 추적합니다. 이를 통해 같은 작업을 중복 실행하지 않습니다.

​
파일 구조

{
  "lastChecks": {
    "email": 1707620400,
    "calendar": 1707616800,
    "weather": 1707613200,
    "git": 1707620400
  },
  "lastNotification": {
    "email": 1707620400,
    "calendar": 1707606000
  }
}

​
동작 원리

1

하트비트 트리거

설정된 간격(기본 30분)으로 AI가 깨어납니다.
2

HEARTBEAT.md 읽기

체크리스트를 확인합니다.
3

상태 확인

heartbeat-state.json에서 마지막 체크 시간을 확인합니다.
4

필요한 작업만 실행

충분한 시간이 지난 작업만 실행합니다.
5

상태 업데이트

완료 후 heartbeat-state.json을 갱신합니다.

​
체크 주기 예시

# HEARTBEAT.md
체크 주기:
- 이메일: 1시간마다
- 캘린더: 2시간마다  
- 날씨: 6시간마다
- git 상태: 4시간마다
하트비트 자체는 30분마다 실행되지만, heartbeat-state.json을 통해 각 작업의 실행 주기를 개별적으로 관리할 수 있습니다.

​
수동 리셋

특정 체크를 강제로 다시 실행하고 싶다면: 
# heartbeat-state.json에서 해당 키의 타임스탬프를 0으로
# 또는 AI에게 요청
"이메일 체크 상태 리셋하고 지금 바로 체크해줘"
heartbeat-state.json은 AI가 자동으로 관리합니다. 직접 편집할 일은 거의 없지만, 구조를 이해하면 디버깅에 도움이 됩니다.