Keepresso
Keepresso
Keepresso 사용하기

명령줄에서 Mac 깨어 있게 하기

György
감수
György
업데이트 Oct 28, 2026 3 min

Keepresso에는 작은 명령줄 도구가 딸려 있어서, 메뉴 막대에 손을 뻗지 않고도 터미널, 셸 스크립트, Makefile, CI 작업에서 제어할 수 있습니다. 명령어는 keepresso이며, 두 가지 방식으로 동작합니다. 메뉴 막대 앱과 통신하거나, 기본 내장 caffeinate처럼 그 자체로 Mac을 깨어 있게 할 수 있습니다.

명령어 설치하기

Homebrew로 Keepresso를 설치했다면 keepresso 명령어는 이미 PATH에 들어 있으므로 아무것도 할 필요가 없습니다.

brew install --cask gyorgysh/keepresso/keepresso

DMG로 앱을 설치했다면 이 도구는 앱 번들 안에 있으며 해당 경로는 아직 PATH에 포함되어 있지 않습니다. 한 번만 링크하세요.

sudo ln -s /Applications/Keepresso.app/Contents/Helpers/keepresso /usr/local/bin/keepresso

제대로 연결되었는지 확인하세요.

keepresso version

앱 제어하기

이 명령들은 Keepresso 앱에 전달되며, 아직 실행 중이 아니라면 앱을 실행시킵니다. 메뉴를 스크립트로 옮겨놓은 것과 같습니다.

keepresso start                 # start an open-ended session
keepresso start --for 90        # start a 90 minute session
keepresso start --until 18:00   # run until a wall-clock time
keepresso stop                  # end the current session
keepresso toggle                # flip it on or off

따라서 작업이 진행되는 동안 잠자기를 막고, 작업이 끝나면 Mac이 평소처럼 잠들 수 있게 합니다.

keepresso start
make release
keepresso stop

상태 확인하기

keepresso status는 세션이 실행 중인지 알려주며, 종료 코드로 스크립트 안에서 쉽게 분기할 수 있습니다.

  • 0 잠자기 방지 활성
  • 1 잠자기 방지 비활성
  • 2 앱이 실행 중이 아님
keepresso status && echo "awake" || echo "asleep"

기계가 읽을 수 있는 결과가 필요하면 --json을 추가하세요.

keepresso status --json

같은 세션 상태는 파일에도 그대로 반영되므로, 메뉴 막대 도구, 상태 표시줄, 위젯이 아무것도 실행하지 않고도 읽을 수 있습니다.

~/Library/Application Support/Keepresso/status.json

현재 상태와 ISO 8601 형식의 타임스탬프가 담겨 있습니다.

앱 없이 단독으로 유지하기

때로는 앱을 전혀 관여시키고 싶지 않고, 그저 이 셸 하나가 Mac을 깨어 있게 해주길 바랄 수 있습니다. caffeinate와 완전히 같은 방식입니다. 이 모드에서는 keepresso 프로세스 자체가 잠자기 방지 요청을 유지하며, 프로세스가 종료되는 순간 Mac은 다시 자유롭게 잠들 수 있습니다.

keepresso -i            # hold until you press Ctrl-C
keepresso -t 3600       # hold for a number of seconds
keepresso -w 5123       # hold until process 5123 exits
keepresso -d            # also keep the display awake (combine with the above)
keepresso -u            # declare user activity: wake the display now

가장 유용한 패턴은 깨어 있는 상태를 명령이나 셸의 수명에 묶는 것입니다.

keepresso -w $$ &       # stay awake as long as this shell lives
ffmpeg -i in.mov out.mp4 & keepresso -w $!   # 인코딩이 끝날 때까지 깨어 있게

이 유지 상태는 실제 macOS 잠자기 방지 요청이므로, pmset -g assertions에도, Keepresso 자체의 활동 탭에도 Mac을 깨어 있게 하는 다른 모든 앱과 나란히 나타납니다.

스크립트와 에이전트를 위한 자동화 리스

stop 없는 start는 스크립트가 충돌하면 Mac을 영원히 깨어 있는 상태로 고정할 수 있습니다. 무인 자동화라면 대신 리스를 획득하세요. 소유자가 계속 갱신해야 하는 유효 기간이 있는 권한입니다. 도구가 비정상 종료되면 리스는 만료되고 Mac은 다시 잠들 수 있습니다.

ID=$(uuidgen)
keepresso lease acquire --id "$ID" --tool my-script --task "nightly render" --ttl 600
keepresso lease heartbeat --id "$ID"   # renew before half the TTL elapses, on a loop
keepresso lease release --id "$ID"     # done, let the Mac rest
keepresso lease list --json            # every live lease, machine-readable

활성 리스는 카운트다운과 함께 메뉴에 표시되고, Keepresso가 이를 모두 합치며, 최대 수명(최대 7일 상한)은 하트비트로도 늘릴 수 없는 상한입니다. 전체 프로토콜, MCP 서버, 원클릭 에이전트 스킬은 AI 에이전트가 Mac을 깨어 있게 하기에서 다룹니다.

깨우기 일정

CLI는 시스템의 예약된 깨우기를 읽을 수 있고, 당신이 허용하면 이를 변경할 수도 있습니다.

keepresso wake status                          # read the schedule, always allowed
keepresso wake set --at "2026-07-24 07:30"     # one-shot wake
keepresso wake set --repeat MTWRF --time 07:30 # repeating wake
keepresso wake clear

status는 누구나 사용할 수 있습니다. set과 clear는 관리자 헬퍼를 통해 시스템 전체의 변경을 적용하므로, 환경설정 → 자동화 아래의 자동화가 깨우기 일정을 변경하도록 허용이 켜져 있을 때만 동작합니다. 기본값은 꺼짐입니다.

반복 깨우기는 일광 절약 시간 전환에도 선택한 현지 시간을 따릅니다. 잘못된 날짜는 거부됩니다. 이 수정은 1.25 이상에 적용됩니다.

관련 문서

Keepresso 받기

macOS 14 이상에서 무료로 사용할 수 있는 오픈소스 앱입니다. 설치하고 당신의 방식대로 Mac을 깨어 있게 하세요.

사람이 주도하고 검증 · AI 보조 콘텐츠 · AI 도구는 초안 작성, 편집, 유지 관리, 문법과 명확성 개선을 도울 수 있습니다. 자동으로 게시되는 내용은 없으며, 모든 변경 사항을 사람 관리자가 검토합니다.