keepresso CLI ile Mac'inizi komut satırından uyanık tutun

Keepresso, menü çubuğuna uzanmadan onu terminal, bir kabuk betiği, bir Makefile veya bir CI işinden kontrol edebilmeniz için küçük bir komut satırı aracıyla birlikte gelir. Komut keepresso komutudur ve iki şekilde çalışır: menü çubuğu uygulamasıyla konuşabilir veya yerleşik caffeinate gibi kendi başına Mac'i uyanık tutabilir.

Komutu yükleyin

Keepresso'yu Homebrew ile yüklediyseniz, keepresso komutu zaten PATH'inizdedir, yapacak bir şey yoktur:

brew install --cask gyorgysh/keepresso/keepresso

Uygulamayı DMG'den yüklediyseniz, araç uygulama paketinin içinde oturur ve PATH'iniz bunu henüz bilmez. Bir kez bağlayın:

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

Bağlandığını kontrol edin:

keepresso version

Uygulamayı kontrol edin

Bu komutlar Keepresso uygulamasına iletilir ve henüz çalışmıyorsa başlatılır. Bunlar menünün betiklenebilir ikizidir.

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

Böylece uzun bir iş başladığında Mac'i uyandırabilir ve bittiğinde uyumasına izin verebilirsiniz:

keepresso start
make release
keepresso stop

Durumu okuyun

keepresso status bir oturumun çalışıp çalışmadığını söyler ve çıkış kodu bir betikte dallanmayı kolaylaştırır:

• 0 Mac uyanık tutuluyor
• 1 tutulmuyor
• 2 uygulama çalışmıyor

keepresso status && echo "awake" || echo "asleep"

Makine tarafından okunabilir bir yanıt için --json ekleyin:

keepresso status --json

Aynı oturum durumu bir dosyaya da yansıtılır, böylece bir menü çubuğu aracı, bir durum satırı veya bir araç takımı hiçbir şey başlatmadan okuyabilir:

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

Geçerli durumu ve ISO 8601 zaman damgalarını taşır.

Bağımsız tutuşlar, uygulama gerekmez

Bazen uygulamayı hiç devreye sokmak istemezsiniz, yalnızca bu kabuğun Mac'i uyanık tutmasını istersiniz, tıpkı caffeinate gibi. Bu modda keepresso süreci kendisi güç onayını tutar ve süreç çıktığı anda Mac tekrar uyuyabilir.

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

En kullanışlı kalıp, uyanıklığı bir komutun veya bir kabuğun ömrüne bağlamaktır:

keepresso -w $$ &       # stay awake as long as this shell lives

ffmpeg -i in.mov out.mp4 & keepresso -w $!   # hold until the encode finishes

Bu tutuşlar gerçek macOS güç onayları olduğu için pmset -g assertions çıktısında ve Keepresso'nun kendi Etkinlik bölmesinde, Mac'i ayakta tutan diğer her uygulamanın yanında görünür.

Otomasyon kiralamaları, betikler ve ajanlar için

stop olmadan bir start, betik çökerse Mac'i sonsuza dek uyanık sabitleyebilir. Gözetimsiz otomasyon için bunun yerine bir kiralama alın: sahibinin yenilemeye devam etmesi gereken süre sınırlı bir izin. Araç ölürse kiralama sona erer ve Mac tekrar uyuyabilir.

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

Canlı kiralamalar geri sayımlarıyla menüde görünür, Keepresso hepsini birleştirir ve azami ömür (7 günle sınırlı) kalp atışlarının uzatamayacağı bir tavandır. Tam protokol, MCP sunucusu ve tek tıklık ajan becerisi yapay zeka ajanlarının Mac'inizi uyanık tutmasına izin verin kılavuzunda anlatılır.

Uyanma zamanlaması

CLI ayrıca sistemin planlanmış uyanmalarını okuyabilir ve izninizle değiştirebilir:

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 herkese açıktır. set ve clear, yönetici yardımcısı aracılığıyla sistem geneli bir değişiklik uygular, bu yüzden yalnızca Otomasyonun uyanma zamanlamasını değiştirmesine izin ver seçeneği Tercihler, Otomasyon altında açıkken çalışır. Varsayılan olarak kapalıdır.

İlgili

• Keepresso'yu Shortcuts, Raycast veya bir betikten kontrol edin terminal gerektirmeyen otomasyon için Shortcuts eylemlerini ve keepresso:// URL şemasını kapsar.
• Keepresso ile Amphetamine, KeepingYouAwake ve caffeinate Keepresso'nun yerleşik caffeinate komutuyla ilişkisini açıklar.