Skip to content

teaway 0.3.0 — Run a Mac like an always-on server

Choose a tag to compare

@soundadam soundadam released this 26 Jul 13:44
· 22 commits to main since this release
Immutable release. Only release title and notes can be modified.
6bae754

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, and unregister for 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: off restores 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 status

Upgrade note

After upgrading an installation that uses registered authorization, run:

teaway auth status
teaway auth register

A 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.