Paseo 매일 오전 10시 자동화: cron·시간대·heartbeat를 정확히 구분하기

PASEO FIELD GUIDE · 09 / 10

매일 CI 상태를 확인하고 중요한 실패만 정리하는 작업은 자동화하기 좋다. 하지만 “매일 10시”에는 두 가지 조건이 숨어 있다. 어느 시간대의 10시인가, 그리고 매번 새 대화로 시작할 것인가다. Paseo의 schedule과 heartbeat를 구분하면 이 조건을 정확히 표현할 수 있다.

대상: 반복 조사·보고·개발 점검을 자동화하는 사용자. 2026-11-07 공식 문서와 로컬 CLI 0.15.0의 schedule create --help를 대조했다. 아래 생성 명령은 설명용이며 이 글 작성 중 Paseo 작업을 등록하지 않았다.

1. schedule은 새 에이전트, heartbeat는 기존 대화

schedule은 cron 시각마다 새 에이전트를 시작한다. 매일의 점검을 독립적으로 수행하고 결과를 비교하기에 적합하다. heartbeat는 특정 기존 에이전트에 반복 프롬프트를 보내 같은 대화의 작업을 재평가하고 이어가게 한다.

목적 선택 기준
매일 PR·CI 현황 조사 schedule로 새로운 실행
현재 빌드가 끝날 때까지 점검 기존 작업의 heartbeat 고려
외부 이벤트가 생겼을 때 시작 시간 기반 cron 외의 이벤트 연결 검토

새 에이전트는 이전 실행의 대화를 그대로 이어받는다고 가정할 수 없다. 매일 비교할 정보는 저장소의 보고서나 지정한 저장 위치 등에서 읽도록 지시한다. 반대로 heartbeat는 기존 대화에 의존하므로 무엇을 완료하면 멈출지도 설계한다.

2. 한국 시간 오전 10시는 시간대까지 적는다

다음은 Codex가 설정된 데몬에서 매일 오전 10시에 읽기 중심의 점검을 수행하는 예시다. /srv/projects/my-app은 데몬 머신에 존재하는 경로로 바꾼다. 이 명령은 POSIX 셸 문법이다.

paseo schedule create \
  --cron "0 10 * * *" \
  --timezone Asia/Seoul \
  --name daily-ci-review \
  --provider codex \
  --cwd /srv/projects/my-app \
  --max-runs 10 \
  "CI 실패와 열린 PR을 조사하라. 소스를 수정하거나 외부에 게시하지 말고, 근거 링크와 우선순위를 최종 응답에 남겨라."

0 10 * * *는 매일 10시 0분이다. 기본 시간대가 UTC이므로 --timezone Asia/Seoul을 빠뜨리면 한국 시간 오전 10시가 되지 않는다. 저장된 nextRunAt이 UTC 표현인 것은 정상이며, 표시 문자열보다 같은 시각을 가리키는지 확인한다.

--max-runs 10은 무한 반복 대신 시험 운영의 경계를 정하는 값이다. 위 예시는 생성 직후 실행하는 --run-now를 사용하지 않으므로 다음 cron 일치 시각을 기다린다. 이를 붙이면 즉시 실행 한 번이 추가된다는 점을 고려한다.

3. every는 생성 시점부터의 타이머가 아니다

--every 5m이나 --every 1h는 간편한 주기 표기지만 내부적으로 cron으로 변환된다. 생성 버튼을 누른 순간을 기준으로 계속 밀려가는 interval이라고 이해하면 예상 실행 시각이 어긋날 수 있다.

운영에서는 생성 결과와 다음 실행 시각을 확인하고 다음 명령으로 관리한다. <id>는 생성된 schedule ID다.

paseo schedule ls
paseo schedule inspect <id>
paseo schedule logs <id>
paseo schedule run-once <id>

run-once는 실제 작업을 시작한다. 본격적인 정기 실행 전에 테스트할 때만 의도적으로 사용한다. 확인할 것은 스케줄 등록 여부뿐 아니라 대상 저장소, provider, 인증, 조사 결과와 실패 로그다. 잠든 노트북이나 꺼진 서버에서 실행을 기대하지 않도록 데몬의 운영 조건도 맞춘다. 중단 동안의 실행이 자동 보충되는지는 별도로 확인하기 전까지 전제하지 않는다.

4. 실행 후 workspace가 사라지는 기본 동작

schedule의 Archive on finish는 기본 활성화다. 실행이 끝나면 workspace와 에이전트가 archive되며, worktree 격리였다면 마지막 활성 참조가 archive될 때 worktree도 제거된다.

실행 산출물이 그 디렉터리에만 있으면 나중에 확인하기 곤란해질 수 있다. 보고서 저장 위치를 분명히 하거나 앱의 Schedules 화면에서 Archive on finish를 끈다. 현재 공식 문서는 이 설정을 바꾸는 CLI·MCP 옵션이 없다고 설명한다. 존재하지 않는 --no-archive 같은 플래그를 추측해서 쓰지 않는다.

5. heartbeat는 종료 조건까지 한 묶음으로 설계한다

현재 에이전트 안에서 다음처럼 heartbeat를 만들 수 있다.

paseo heartbeat create --cron "*/20 * * * *" --name build-followup "현재 빌드 상태를 확인하고 남은 작업을 정리하라."

heartbeat는 Paseo가 에이전트 세션에 설정하는 PASEO_AGENT_ID가 필요하다. 아무 외부 터미널에서 실행하면 대상 대화가 자동으로 정해지는 것은 아니다. 이 인터페이스는 raw cron을 사용하며 --every와 구분한다. 완료 후에는 해당 ID를 이용해 heartbeat를 삭제하는 절차도 준비한다.

마지막으로 Paseo의 정기 실행과 블로그 예약 발행은 서로 다른 기능이다. 글을 조사하는 에이전트를 매일 시작했다고 CMS에 게시 시각이 등록된 것은 아니다. 콘텐츠 자동화에서는 조사·검수 완료와 CMS의 예약 상태를 별도로 확인해야 한다.

참고 자료

댓글