Homebrew tap: publish pilotctl via brew

[TeoSlayer]

Scope

Distribute pilotctl (and optionally pilot-daemon, pilot-gateway) via Homebrew so macOS and Linux users can install with a single command.

Deliverables

Homebrew Tap Repository

• Create homebrew-pilot tap repository (e.g., TeoSlayer/homebrew-pilot)
• Formula for pilotctl (primary CLI)
• Formula for pilot-daemon (background service)
• Formula for pilot-gateway (optional)

Formula Requirements

• Download pre-built binaries from GitHub Releases (darwin/arm64, darwin/amd64, linux/amd64, linux/arm64)
• SHA256 verification for all artifacts
• Version pinning from release tags
• brew install pilotctl as the primary install path
• brew services start pilot-daemon for launchd integration on macOS

Release Automation

• GitHub Actions workflow: on release tag, build binaries, compute SHA256, update formula
• Goreleaser config for cross-compilation and artifact packaging
• Bottle generation for common platforms (speeds up install)

Install Experience

# Add tap
brew tap pilotprotocol/pilot

# Install CLI
brew install pilotctl

# Start daemon as a service
brew services start pilot-daemon

# Verify
pilotctl daemon status

launchd Integration (macOS)

• Plist file for pilot-daemon service
• Auto-start on login
• Log to ~/Library/Logs/pilot-daemon.log
• Configurable via ~/.pilot/config.json

Files

• homebrew-pilot/ — new tap repository
• .goreleaser.yml — release automation config
• .github/workflows/release.yml — CI release pipeline
• install.sh — update to detect and suggest brew if available

Priority: MEDIUM