Halos

Native macOS control surface for Huma and Lazuli. Halos is a Mission Control/Dock app with Latch-style HUD glass, compact controls, and a native activity log while Lazuli is driving the desktop.

Dev

swift build
swift test
./script/build_and_run.sh

Stack

• Shell: AppKit mission-control window
• UI: SwiftUI
• Native feel: NSVisualEffectView HUD glass, Dock/Mission Control presence, native SF typography
• Backend bridge: reads ~/.lazuli/current-port, subscribes to ws://127.0.0.1:<port>/events

Layout

Path	What
Sources/HalosApp	App delegate and AppKit window controller
Sources/Halos	SwiftUI views, Lazuli event store, theme
Tests/HalosUITests	Event formatter coverage
script/build_and_run.sh	Builds, signs, and opens dist/Halos.app
assets/AppIcon.icns	Bundle icon

Backend (unchanged from prior versions)

• PostgREST @ localhost:3001
• OpenClaw gateway @ localhost:18789

Install locally

./script/build_and_run.sh build
osascript -e 'tell application "Halos" to quit' 2>/dev/null || true
trash ~/Applications/Halos.app 2>/dev/null || true
cp -R dist/Halos.app ~/Applications/