MacRack

Turn your MacBook into an always-on server.
No more accidental sleep, screen burn, or glowing keyboards at 3am.

Prerequisites

• Enable Auto-login: System Settings → Users & Groups → Automatic Login
• Disable FileVault: required for auto-login to work

Without auto-login, the Launch Agent won’t start until someone logs in.

Installation

brew install 851-labs/tap/macrack
brew services start macrack

Usage

macrack                      # Show current status (default)
macrack status -v            # Verbose status
macrack status -j            # JSON output for scripting
macrack config               # Show current configuration
macrack config --interval 60 # Set check interval to 60 seconds
macrack logs -n 50           # Show last 50 log lines
macrack logs -f              # Follow log output

Service management (via Homebrew):

brew services start macrack
brew services stop macrack
brew services restart macrack

Configuration

Config file location:

~/.config/macrack/config.json

Defaults:

{
  "brightnessLockEnabled": true,
  "volumeLockEnabled": true,
  "keyboardBacklightLockEnabled": true,
  "checkIntervalSeconds": 30,
  "autoPauseEnabled": true,
  "autoPauseIdleThresholdSeconds": 300
}

Agent

The Launch Agent runs macrack agent and:

• Spawns caffeinate -s -d -i -u
• Enforces brightness, keyboard backlight (CoreBrightness), and volume every interval
• Pauses enforcement when user activity is detected
• Reloads configuration on SIGHUP

Development

swift build
swift run macrack status

Tech Stack

• OpenCode - AI Coding Agent
• Swift 6.2
• Swift Argument Parser - CLI Framework
• Rainbow - Terminal colors
• swift-log - Logging

License

This project is released under the MIT License. See LICENSE for details.

Support

If you like this project, please consider giving it a star.