teaway 0.3.0 — Run a Mac like an always-on server
Run a Mac like an always-on server
teaway 0.3.0 turns the project into a focused power-control layer for headless and long-running Mac setups: a closed-lid MacBook build box, a Mac mini home server, a homelab node, or any workload that should outlive one terminal session.
Highlights
- Adds
teaway auth register,status, andunregisterfor a root-owned per-user helper with a narrow passwordless sudoers policy. - Preserves the ordinary sudo credential timestamp instead of forcing a new password prompt for every operation.
- Keeps awake-state ownership reversible:
offrestores only the exact setting owned by teaway and leaves external state unchanged. - Adds exact delayed-shutdown transactions with macOS 26 two/four-digit schedule normalization and targeted cancellation.
- Adds GitHub-hosted macOS CI, documentation integrity checks, and a complete operations/security documentation system.
- Repositions README and repository topics around headless Mac, home server, homelab, self-hosted, and closed-lid operation.
Install
brew install soundadam/tap/teaway
teaway auth register
teaway on
teaway statusUpgrade note
After upgrading an installation that uses registered authorization, run:
teaway auth status
teaway auth registerA stale helper is rejected until it is visibly refreshed to the same version as the CLI.
Safety and trust boundary
Registered mode delegates only disablesleep values 0/1 and exact teaway-owned shutdown schedule/cancel operations. It does not grant arbitrary pmset, public CLI, or shell execution. Use it only on a trusted single-user macOS account.
Keep a closed laptop on AC power, stationary, and well ventilated. teaway does not configure SSH, networking, service supervision, monitoring, backups, or high availability.
Distribution
This release publishes the immutable source tag only. The Homebrew Formula builds from source. No unnotarized prebuilt executable is attached.