MAC-MENUBAR-APP — v2 Spec

Status: DEFERRED — v2 (user on Windows)

Effort: 6–8h

Owner: Harnoor / FORGE when on macOS

---

Concept

A lightweight macOS menubar widget that:

Shows the current TITAN mood face icon in the menubar at all times
Displays a 1-line status string (e.g. "3 agents running · 12 tasks open")
Single left-click → opens TITAN HQ (https://jarvis.livegroweveryday.com/) in default browser
Right-click → context submenu (see below)

---

Menu Structure


TITAN  [mood face icon]  "3 agents · 12 tasks"
───────────────────────────────────────────────
  Open TITAN HQ        ⌘T
  Open Voice           ⌘V
  Open Tasks           ⌘K
  ─────────────────────
  Pause Notifications  (toggle checkmark)
  ─────────────────────
  Quit TITAN           ⌘Q

---

Stack Options

Option A — Swift + AppKit (recommended)

NSStatusItem + NSMenu
NSStatusBarButton.image set from a bundled PNG or fetched from S3 mood URL
Background Timer polls s3://innerverse-voice-scratch/titan-state/current-mood.json every 30s
No Electron, no Node, ~4 MB bundle

Option B — Tauri (fallback if Swift dev not available)

Tauri 2 has a tray-icon plugin
Cross-platform but heavier (~15 MB)
Reuses the same Tauri project at F:/TITAN/mobile/tauri/

---

Mood State Polling

Endpoint: https://innerverse-voice-scratch.s3.amazonaws.com/titan-state/current-mood.json

Expected shape:


{ "mood": "welcoming", "status": "3 agents · 12 tasks" }

Mood → icon mapping (match Windows tray palette):

| Mood | Color |

|------------|---------|

| welcoming | #48C78E |

| thinking | #5A78FF |

| alert | #FF5050 |

| idle | #A0A0A0 |

---

Implementation Steps (when macOS available)

1. Create F:/TITAN/mobile/menubar-mac/ Xcode project (or clone Tauri project)

2. Add NSStatusItem in AppDelegate.swift

3. Wire mood poll timer → update statusItem.button?.image

4. Build menu items linking to each TITAN URL via NSWorkspace.shared.open()

5. Code-sign with Developer ID cert (requires Apple Developer account, $99/yr)

6. Notarize via xcrun notarytool

7. Distribute as .dmg or add to TITAN installer

---

Dependencies

macOS 13+ Ventura
Xcode 15+
Apple Developer Program membership ($99/yr) for notarization
Swift 5.9+

---

Revisit when TITAN needs a macOS presence — estimate Q3 2026.