pacatui 0.1.13 → 0.1.15

package/README.md

@@ -16,6 +16,7 @@ A simple TUI app for task, timer and invoicing for projects.
 - **Stripe Invoicing** - Create draft invoices directly from time entries
 - **Invoice Management** - View and manage all your Stripe invoices
 - **Dashboard** - Overview of projects, tasks, and time stats
+- **Menu Bar** - Native macOS menu bar companion for quick timer control
 - **Offline-first** - All data stored locally in SQLite
 - **Vim-style Navigation** - Keyboard-driven interface
 
@@ -120,6 +121,7 @@ Access settings by pressing `5`:
 - **Business Name** - Your business name for invoices
 - **Stripe API Key** - Enable invoicing features
 - **Timezone** - Set display timezone (or auto-detect)
+- **Menu Bar** - Toggle the macOS menu bar companion
 - **Export/Import** - Backup and restore your data
 
 ### Data Location
@@ -127,6 +129,27 @@ Access settings by pressing `5`:
 - Database: `~/.paca/paca.db`
 - Backups: `~/.paca/backups/`
 
+## Menu Bar (macOS)
+
+Paca includes a native macOS menu bar companion that shows your running timer and lets you start/stop timers without opening the TUI.
+
+### Enable via Settings
+
+1. Press `5` to open Settings
+2. Select **Menu Bar** and press `Enter` to toggle it on
+
+### Enable via CLI
+
+```bash
+paca menubar enable    # Compile & launch
+paca menubar disable   # Stop & remove
+paca menubar status    # Show current status
+```
+
+The first time you enable it, Paca compiles a small native Swift helper binary (requires Xcode Command Line Tools). The paca mascot icon appears in your menu bar with live timer status.
+
+**Requires**: Xcode Command Line Tools (`xcode-select --install`)
+
 ## Stripe Integration
 
 To enable invoicing:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pacatui",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "A simple tui app for task, timer and invoicing for projects.",
   "module": "src/index.tsx",
   "type": "module",
@@ -66,6 +66,7 @@
     "@prisma/adapter-libsql": "^7.2.0",
     "@prisma/client": "^7.2.0",
     "better-sqlite3": "^12.6.0",
+    "paca4": ".",
     "prisma": "^7.2.0",
     "react": "^19.2.3",
     "stripe": "^20.2.0"

package/src/App.tsx

@@ -109,6 +109,7 @@ export function App() {
 		stripeApiKey: "",
 		timezone: "auto",
 		theme: "catppuccin-mocha",
+		menuBar: "disabled",
 	});
 
 	// Timesheet State
@@ -364,6 +365,30 @@ export function App() {
 		loadCustomers();
 	}, []);
 
+	// Poll for external timer changes (e.g. from menu bar)
+	// Uses bun:sqlite directly to bypass Prisma's connection cache
+	useEffect(() => {
+		const poll = setInterval(async () => {
+			const { getRunningTimer: getRunningTimerLite } = await import("./menubar/db-lite.ts");
+			const row = getRunningTimerLite();
+			if (row) {
+				setRunningTimer({
+					id: row.id,
+					startTime: new Date(row.startTime.includes("T") ? row.startTime : row.startTime + "Z"),
+					project: {
+						id: row.projectId,
+						name: row.projectName,
+						color: row.projectColor,
+						hourlyRate: row.projectHourlyRate,
+					},
+				});
+			} else {
+				setRunningTimer(null);
+			}
+		}, 5000);
+		return () => clearInterval(poll);
+	}, []);
+
 	// Reload tasks when project selection changes
 	useEffect(() => {
 		loadTasks();
@@ -860,10 +885,13 @@ export function App() {
 				case 3: // Timezone
 					setInputMode("edit_timezone");
 					break;
-				case 4: // Export Database
+				case 4: // Menu Bar
+					handleToggleMenuBar();
+					break;
+				case 5: // Export Database
 					handleExportDatabase();
 					break;
-				case 5: // Import Database
+				case 6: // Import Database
 					setConfirmMessage("Import will replace all data. Continue?");
 					setConfirmAction(() => () => handleImportDatabase());
 					break;
@@ -1177,6 +1205,18 @@ export function App() {
 		showMessage(`Theme: ${theme.displayName}`);
 	};
 
+	const handleToggleMenuBar = async () => {
+		const newValue = appSettings.menuBar === "enabled" ? "disabled" : "enabled";
+		await settings.set("menuBar", newValue);
+		setAppSettings((prev) => ({ ...prev, menuBar: newValue }));
+
+		const { enableMenuBar, disableMenuBar } = await import("./menubar/index.ts");
+		const msg = newValue === "enabled"
+			? await enableMenuBar()
+			: await disableMenuBar();
+		showMessage(msg);
+	};
+
 	// Modal handlers
 	const handleCreateProject = async (name: string, rate: number | null) => {
 		await projects.create({ name, hourlyRate: rate });
@@ -1437,6 +1477,7 @@ export function App() {
 						onEditStripeKey={() => setInputMode("edit_stripe_key")}
 						onEditTimezone={() => setInputMode("edit_timezone")}
 						onSelectTheme={() => setInputMode("select_theme")}
+						onToggleMenuBar={handleToggleMenuBar}
 						onExportDatabase={handleExportDatabase}
 						onImportDatabase={() => {
 							setConfirmMessage("Import will replace all data. Continue?");

package/src/components/SettingsView.tsx

@@ -9,6 +9,7 @@ interface SettingsViewProps {
   onEditStripeKey: () => void;
   onEditTimezone: () => void;
   onSelectTheme: () => void;
+  onToggleMenuBar: () => void;
   onExportDatabase: () => void;
   onImportDatabase: () => void;
 }
@@ -18,6 +19,7 @@ const SETTINGS_ITEMS = [
   { key: "stripeApiKey", label: "Stripe API Key", type: "secret" },
   { key: "theme", label: "Theme", type: "select" },
   { key: "timezone", label: "Timezone", type: "text" },
+  { key: "menuBar", label: "Menu Bar", type: "toggle" },
   { key: "exportDatabase", label: "Export Database", type: "action" },
   { key: "importDatabase", label: "Import Database", type: "action" },
 ] as const;
@@ -30,6 +32,7 @@ export function SettingsView({
   onEditStripeKey,
   onEditTimezone,
   onSelectTheme,
+  onToggleMenuBar,
   onExportDatabase,
   onImportDatabase,
 }: SettingsViewProps) {
@@ -63,6 +66,8 @@ export function SettingsView({
         return maskSecret(settings.stripeApiKey);
       case "timezone":
         return formatTimezone(settings.timezone);
+      case "menuBar":
+        return settings.menuBar === "enabled" ? "Enabled" : "Disabled";
       case "exportDatabase":
         return "Export to file...";
       case "importDatabase":
@@ -82,6 +87,8 @@ export function SettingsView({
         return onEditStripeKey;
       case "timezone":
         return onEditTimezone;
+      case "menuBar":
+        return onToggleMenuBar;
       case "exportDatabase":
         return onExportDatabase;
       case "importDatabase":
@@ -94,6 +101,7 @@ export function SettingsView({
   const getActionLabel = (type: string) => {
     if (type === "action") return "run";
     if (type === "select") return "select";
+    if (type === "toggle") return "toggle";
     return "edit";
   };
 

package/src/db.ts

@@ -631,6 +631,7 @@ export const settings = {
       stripeApiKey: all.stripeApiKey ?? "",
       timezone: all.timezone ?? "auto",
       theme: all.theme ?? "catppuccin-mocha",
+      menuBar: all.menuBar ?? "disabled",
     };
   },
 };

package/src/index.tsx

@@ -138,6 +138,14 @@ function showSplash(theme: Theme): boolean {
 }
 
 async function main() {
+	// Handle menubar subcommand before TUI setup
+	const args = process.argv.slice(2);
+	if (args[0] === "menubar") {
+		const { menubarCommand } = await import("./menubar/index.ts");
+		await menubarCommand(args.slice(1));
+		return;
+	}
+
 	// Get stored theme and show splash with ASCII paca
 	const theme = getStoredTheme();
 	const splashShown = showSplash(theme);
@@ -177,6 +185,21 @@ async function main() {
 	// Clean up tasks that have been done for more than 3 days
 	await cleanupOldCompletedTasks(3);
 
+	// Auto-launch menu bar helper if enabled
+	try {
+		const db2 = new Database(DB_PATH, { readonly: true });
+		const menuBarSetting = db2
+			.query("SELECT value FROM Setting WHERE key = 'menuBar'")
+			.get() as { value: string } | null;
+		db2.close();
+		if (menuBarSetting?.value === "enabled") {
+			const { ensureMenuBarRunning } = await import("./menubar/index.ts");
+			ensureMenuBarRunning();
+		}
+	} catch {
+		// Non-critical — skip if menu bar can't be launched
+	}
+
 	// Handle cleanup on exit - must stop renderer to restore terminal state
 	const cleanup = async () => {
 		if (renderer) {

package/src/menubar/db-lite.ts

@@ -0,0 +1,103 @@
+import Database from "bun:sqlite";
+import { join } from "path";
+import { homedir } from "os";
+
+const DB_PATH = join(homedir(), ".paca", "paca.db");
+
+function openReadonly(): Database {
+  const db = new Database(DB_PATH, { readonly: true });
+  db.exec("PRAGMA busy_timeout=5000");
+  return db;
+}
+
+function openReadWrite(): Database {
+  const db = new Database(DB_PATH);
+  db.exec("PRAGMA busy_timeout=5000");
+  db.exec("PRAGMA journal_mode=WAL");
+  return db;
+}
+
+export interface RunningTimerRow {
+  id: string;
+  startTime: string;
+  projectId: string;
+  projectName: string;
+  projectColor: string;
+  projectHourlyRate: number | null;
+}
+
+export interface ProjectRow {
+  id: string;
+  name: string;
+  color: string;
+}
+
+export function getRunningTimer(): RunningTimerRow | null {
+  const db = openReadonly();
+  try {
+    const row = db
+      .query<RunningTimerRow, []>(
+        `SELECT te.id, te.startTime, te.projectId,
+                p.name AS projectName, p.color AS projectColor,
+                p.hourlyRate AS projectHourlyRate
+         FROM TimeEntry te
+         JOIN Project p ON p.id = te.projectId
+         WHERE te.endTime IS NULL
+         LIMIT 1`,
+      )
+      .get();
+    return row ?? null;
+  } finally {
+    db.close();
+  }
+}
+
+export function getProjects(): ProjectRow[] {
+  const db = openReadonly();
+  try {
+    return db
+      .query<ProjectRow, []>(
+        `SELECT id, name, color FROM Project WHERE archived = 0 ORDER BY name ASC`,
+      )
+      .all();
+  } finally {
+    db.close();
+  }
+}
+
+export function startTimer(projectId: string): void {
+  const db = openReadWrite();
+  try {
+    // Stop any running timer first
+    const running = db
+      .query<{ id: string }, []>(
+        `SELECT id FROM TimeEntry WHERE endTime IS NULL LIMIT 1`,
+      )
+      .get();
+    if (running) {
+      db.query(
+        `UPDATE TimeEntry SET endTime = datetime('now'), updatedAt = datetime('now') WHERE id = ?`,
+      ).run(running.id);
+    }
+
+    // Start new timer
+    const id = crypto.randomUUID();
+    db.query(
+      `INSERT INTO TimeEntry (id, projectId, startTime, createdAt, updatedAt)
+       VALUES (?, ?, datetime('now'), datetime('now'), datetime('now'))`,
+    ).run(id, projectId);
+  } finally {
+    db.close();
+  }
+}
+
+export function stopTimer(entryId: string, description?: string): void {
+  const db = openReadWrite();
+  try {
+    db.query(
+      `UPDATE TimeEntry SET endTime = datetime('now'), description = ?, updatedAt = datetime('now') WHERE id = ?`,
+    ).run(description ?? null, entryId);
+  } finally {
+    db.close();
+  }
+}

package/src/menubar/index.ts

@@ -0,0 +1,243 @@
+import { existsSync, writeFileSync, unlinkSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { execSync, spawn } from "child_process";
+import { getSwiftSource } from "./swift-source.ts";
+import { getRunningTimer, getProjects } from "./db-lite.ts";
+
+const PACA_DIR = join(homedir(), ".paca");
+const BINARY_PATH = join(PACA_DIR, "paca-menubar");
+const SWIFT_PATH = join(PACA_DIR, "paca-menubar.swift");
+const PID_PATH = join(PACA_DIR, "menubar.pid");
+const ICON_PATH = join(PACA_DIR, "paca-icon.png");
+
+function hasSwiftCompiler(): boolean {
+  try {
+    execSync("which swiftc", { encoding: "utf-8", stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function prepareMascotIcon(): string {
+  // Find the mascot image relative to source directory
+  const srcDir = dirname(dirname(import.meta.dir));
+  const mascotPath = join(srcDir, "assets", "paca-mascot.png");
+
+  if (!existsSync(mascotPath)) {
+    return "";
+  }
+
+  try {
+    // Resize to 36x36 (18pt @2x retina) using sips (built into macOS)
+    execSync(
+      `sips --resampleHeight 36 ${JSON.stringify(mascotPath)} --out ${JSON.stringify(ICON_PATH)} 2>/dev/null`,
+      { encoding: "utf-8", stdio: "pipe" },
+    );
+    const iconData = readFileSync(ICON_PATH);
+    unlinkSync(ICON_PATH);
+    return iconData.toString("base64");
+  } catch {
+    return "";
+  }
+}
+
+function compileBinary(): boolean {
+  const iconBase64 = prepareMascotIcon();
+  writeFileSync(SWIFT_PATH, getSwiftSource(iconBase64), "utf-8");
+  try {
+    execSync(
+      `swiftc -O -o ${JSON.stringify(BINARY_PATH)} ${JSON.stringify(SWIFT_PATH)} -framework Cocoa -lsqlite3 2>&1`,
+      { encoding: "utf-8", timeout: 60_000 },
+    );
+    unlinkSync(SWIFT_PATH);
+    return true;
+  } catch (error: any) {
+    console.error("Failed to compile menu bar helper:");
+    console.error(error.stdout || error.message);
+    if (existsSync(SWIFT_PATH)) unlinkSync(SWIFT_PATH);
+    return false;
+  }
+}
+
+function readPid(): number | null {
+  try {
+    const pid = parseInt(readFileSync(PID_PATH, "utf-8").trim(), 10);
+    return isNaN(pid) ? null : pid;
+  } catch {
+    return null;
+  }
+}
+
+function isProcessRunning(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export function isMenuBarRunning(): boolean {
+  const pid = readPid();
+  return pid !== null && isProcessRunning(pid);
+}
+
+function launchHelper(): boolean {
+  if (!existsSync(BINARY_PATH)) return false;
+
+  const child = spawn(BINARY_PATH, [], {
+    detached: true,
+    stdio: "ignore",
+  });
+
+  if (child.pid) {
+    writeFileSync(PID_PATH, String(child.pid), "utf-8");
+    child.unref();
+    return true;
+  }
+  return false;
+}
+
+function killHelper(): boolean {
+  const pid = readPid();
+  if (pid === null) return false;
+
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch {
+    // Process already gone
+  }
+
+  if (existsSync(PID_PATH)) unlinkSync(PID_PATH);
+  return true;
+}
+
+/**
+ * Enable the menu bar helper. Called from settings toggle or CLI.
+ * Returns a status message string.
+ */
+export async function enableMenuBar(): Promise<string> {
+  if (isMenuBarRunning()) {
+    return "Menu bar is already running.";
+  }
+
+  if (!hasSwiftCompiler()) {
+    return "Xcode Command Line Tools required. Install with: xcode-select --install";
+  }
+
+  // Compile if binary doesn't exist
+  if (!existsSync(BINARY_PATH)) {
+    const ok = compileBinary();
+    if (!ok) return "Failed to compile menu bar helper.";
+  }
+
+  const launched = launchHelper();
+  if (!launched) return "Failed to launch menu bar helper.";
+
+  return "Menu bar enabled.";
+}
+
+/**
+ * Disable the menu bar helper. Called from settings toggle or CLI.
+ * Returns a status message string.
+ */
+export async function disableMenuBar(): Promise<string> {
+  killHelper();
+
+  // Remove binary
+  if (existsSync(BINARY_PATH)) unlinkSync(BINARY_PATH);
+
+  return "Menu bar disabled.";
+}
+
+/**
+ * Ensure the helper is running if the setting is enabled.
+ * Called on paca startup — no-op if already running or not enabled.
+ */
+export function ensureMenuBarRunning(): void {
+  if (isMenuBarRunning()) return;
+  if (!existsSync(BINARY_PATH)) return;
+  launchHelper();
+}
+
+// --- CLI ---
+
+function formatElapsed(startTimeStr: string): string {
+  const startMs = new Date(startTimeStr + "Z").getTime();
+  const elapsedMs = Date.now() - startMs;
+  const totalSec = Math.floor(elapsedMs / 1000);
+  const h = Math.floor(totalSec / 3600);
+  const m = Math.floor((totalSec % 3600) / 60);
+  const s = totalSec % 60;
+  return `${h}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+
+async function cliEnable() {
+  console.log("Compiling menu bar helper...");
+  const msg = await enableMenuBar();
+  console.log(msg);
+}
+
+async function cliDisable() {
+  const msg = await disableMenuBar();
+  console.log(msg);
+}
+
+function cliStatus() {
+  const dbPath = join(PACA_DIR, "paca.db");
+  if (!existsSync(dbPath)) {
+    console.log("No database found. Run paca to initialize.");
+    return;
+  }
+
+  console.log(`Menu bar: ${isMenuBarRunning() ? "running" : "not running"}`);
+  console.log(`Binary: ${existsSync(BINARY_PATH) ? "compiled" : "not compiled"}`);
+  console.log("");
+
+  const running = getRunningTimer();
+  if (running) {
+    const elapsed = formatElapsed(running.startTime);
+    console.log(`Timer running: ${running.projectName} (${elapsed})`);
+  } else {
+    console.log("No timer running.");
+  }
+
+  const allProjects = getProjects();
+  if (allProjects.length > 0) {
+    console.log("");
+    console.log("Projects:");
+    for (const p of allProjects) {
+      console.log(`  - ${p.name}`);
+    }
+  }
+}
+
+function showHelp() {
+  console.log("Menu bar commands:");
+  console.log("  paca menubar enable     Compile & launch menu bar helper");
+  console.log("  paca menubar disable    Stop & remove menu bar helper");
+  console.log("  paca menubar status     Show current status");
+  console.log("");
+  console.log(`Menu bar: ${isMenuBarRunning() ? "running" : "not running"}`);
+  console.log("");
+  console.log("You can also toggle this from Settings in the TUI.");
+}
+
+export async function menubarCommand(args: string[]) {
+  switch (args[0]) {
+    case "enable":
+      await cliEnable();
+      break;
+    case "disable":
+      await cliDisable();
+      break;
+    case "status":
+      cliStatus();
+      break;
+    default:
+      showHelp();
+      break;
+  }
+}

package/src/menubar/swift-source.ts

@@ -0,0 +1,269 @@
+/**
+ * Native macOS menu bar helper — Swift source code.
+ * Compiled with `swiftc` at install time, stored at ~/.paca/paca-menubar.
+ *
+ * @param iconBase64 - Base64-encoded PNG of the paca mascot (36x36 for retina)
+ */
+export function getSwiftSource(iconBase64: string): string {
+  return `
+import Cocoa
+import SQLite3
+
+let SQLITE_TRANSIENT = unsafeBitCast(-1, to: sqlite3_destructor_type.self)
+
+let ICON_BASE64 = "${iconBase64}"
+
+func loadIcon() -> NSImage? {
+    guard let data = Data(base64Encoded: ICON_BASE64) else { return nil }
+    guard let image = NSImage(data: data) else { return nil }
+    // Set point size to 18x18 (the data is @2x retina)
+    image.size = NSSize(width: 18, height: 18)
+    return image
+}
+
+class AppDelegate: NSObject, NSApplicationDelegate {
+    var statusItem: NSStatusItem!
+    var pollTimer: Timer?
+    let dbPath: String
+    var icon: NSImage?
+
+    override init() {
+        let home = FileManager.default.homeDirectoryForCurrentUser
+        dbPath = home.appendingPathComponent(".paca/paca.db").path
+        super.init()
+    }
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
+        icon = loadIcon()
+        statusItem.button?.imagePosition = .imageLeading
+        updateMenu()
+        pollTimer = Timer.scheduledTimer(withTimeInterval: 3.0, repeats: true) { [weak self] _ in
+            DispatchQueue.main.async { self?.updateMenu() }
+        }
+    }
+
+    func updateMenu() {
+        var db: OpaquePointer?
+        guard sqlite3_open_v2(dbPath, &db, SQLITE_OPEN_READONLY, nil) == SQLITE_OK else {
+            setIdleAppearance()
+            statusItem.menu = buildFallbackMenu("Database not found")
+            return
+        }
+        defer { sqlite3_close(db) }
+
+        sqlite3_busy_timeout(db, 5000)
+
+        // Check for running timer
+        var stmt: OpaquePointer?
+        let runningSQL = """
+            SELECT te.id, te.startTime, p.name, p.color
+            FROM TimeEntry te JOIN Project p ON p.id = te.projectId
+            WHERE te.endTime IS NULL LIMIT 1
+        """
+        var runningId: String?
+        var startTime: String?
+        var projectName: String?
+
+        if sqlite3_prepare_v2(db, runningSQL, -1, &stmt, nil) == SQLITE_OK {
+            if sqlite3_step(stmt) == SQLITE_ROW {
+                runningId = col(stmt, 0)
+                startTime = col(stmt, 1)
+                projectName = col(stmt, 2)
+            }
+        }
+        sqlite3_finalize(stmt)
+
+        // Update title and icon
+        if let name = projectName, let start = startTime {
+            let elapsed = formatElapsed(start)
+            let title = " ▶ \\(name) \\(elapsed)"
+            let attrs: [NSAttributedString.Key: Any] = [
+                .foregroundColor: NSColor(red: 0.65, green: 0.89, blue: 0.63, alpha: 1.0),
+                .font: NSFont.monospacedDigitSystemFont(ofSize: NSFont.systemFontSize, weight: .medium)
+            ]
+            statusItem.button?.attributedTitle = NSAttributedString(string: title, attributes: attrs)
+            statusItem.button?.image = icon
+        } else {
+            setIdleAppearance()
+        }
+
+        // Build menu
+        let menu = NSMenu()
+
+        if let entryId = runningId {
+            let stop = NSMenuItem(title: "Stop Timer", action: #selector(stopTimerClicked(_:)), keyEquivalent: "")
+            stop.target = self
+            stop.representedObject = entryId
+            menu.addItem(stop)
+        } else {
+            // Only show project list when no timer is running
+            var pStmt: OpaquePointer?
+            let pSQL = "SELECT id, name FROM Project WHERE archived = 0 ORDER BY name ASC"
+            var projectItems: [(id: String, name: String)] = []
+
+            if sqlite3_prepare_v2(db, pSQL, -1, &pStmt, nil) == SQLITE_OK {
+                while sqlite3_step(pStmt) == SQLITE_ROW {
+                    if let id = col(pStmt, 0), let name = col(pStmt, 1) {
+                        projectItems.append((id: id, name: name))
+                    }
+                }
+            }
+            sqlite3_finalize(pStmt)
+
+            if projectItems.isEmpty {
+                let empty = NSMenuItem(title: "No projects — open paca to create one", action: nil, keyEquivalent: "")
+                empty.isEnabled = false
+                menu.addItem(empty)
+            } else {
+                let header = NSMenuItem(title: "Start Timer For...", action: nil, keyEquivalent: "")
+                header.isEnabled = false
+                menu.addItem(header)
+                for p in projectItems {
+                    let item = NSMenuItem(title: "  \\(p.name)", action: #selector(startTimerClicked(_:)), keyEquivalent: "")
+                    item.target = self
+                    item.representedObject = p.id
+                    menu.addItem(item)
+                }
+            }
+        }
+
+        menu.addItem(NSMenuItem.separator())
+        let quit = NSMenuItem(title: "Quit Paca Menu Bar", action: #selector(quitApp), keyEquivalent: "q")
+        quit.target = self
+        menu.addItem(quit)
+
+        statusItem.menu = menu
+    }
+
+    func setIdleAppearance() {
+        statusItem.button?.image = icon
+        statusItem.button?.title = ""
+        statusItem.button?.attributedTitle = NSAttributedString(string: "")
+    }
+
+    func buildFallbackMenu(_ message: String) -> NSMenu {
+        let menu = NSMenu()
+        let item = NSMenuItem(title: message, action: nil, keyEquivalent: "")
+        item.isEnabled = false
+        menu.addItem(item)
+        menu.addItem(NSMenuItem.separator())
+        let quit = NSMenuItem(title: "Quit Paca Menu Bar", action: #selector(quitApp), keyEquivalent: "q")
+        quit.target = self
+        menu.addItem(quit)
+        return menu
+    }
+
+    func col(_ stmt: OpaquePointer?, _ idx: Int32) -> String? {
+        guard let cStr = sqlite3_column_text(stmt, idx) else { return nil }
+        return String(cString: cStr)
+    }
+
+    func parseDate(_ str: String) -> Date? {
+        // Try ISO8601DateFormatter first (handles Z, +00:00, etc.)
+        let iso = ISO8601DateFormatter()
+        iso.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+        if let d = iso.date(from: str) { return d }
+
+        // Without fractional seconds
+        iso.formatOptions = [.withInternetDateTime]
+        if let d = iso.date(from: str) { return d }
+
+        // Try SQLite datetime() format
+        let sql = DateFormatter()
+        sql.dateFormat = "yyyy-MM-dd HH:mm:ss"
+        sql.timeZone = TimeZone(identifier: "UTC")
+        return sql.date(from: str)
+    }
+
+    func formatElapsed(_ startTimeStr: String) -> String {
+        guard let start = parseDate(startTimeStr) else { return "0:00:00" }
+
+        let elapsed = max(0, Int(Date().timeIntervalSince(start)))
+        let h = elapsed / 3600
+        let m = (elapsed % 3600) / 60
+        let s = elapsed % 60
+        return String(format: "%d:%02d:%02d", h, m, s)
+    }
+
+    // MARK: - Actions
+
+    @objc func stopTimerClicked(_ sender: NSMenuItem) {
+        guard let entryId = sender.representedObject as? String else { return }
+
+        let alert = NSAlert()
+        alert.messageText = "What did you work on?"
+        alert.addButton(withTitle: "Save")
+        alert.addButton(withTitle: "Skip")
+        alert.addButton(withTitle: "Cancel")
+
+        let input = NSTextField(frame: NSRect(x: 0, y: 0, width: 300, height: 24))
+        input.placeholderString = "Description (optional)"
+        alert.accessoryView = input
+        alert.window.initialFirstResponder = input
+
+        NSApp.activate(ignoringOtherApps: true)
+        let response = alert.runModal()
+
+        if response == .alertThirdButtonReturn { return }
+
+        let desc = response == .alertFirstButtonReturn ? input.stringValue : nil
+
+        var db: OpaquePointer?
+        guard sqlite3_open(dbPath, &db) == SQLITE_OK else { return }
+        defer { sqlite3_close(db) }
+        sqlite3_exec(db, "PRAGMA journal_mode=WAL", nil, nil, nil)
+        sqlite3_busy_timeout(db, 5000)
+
+        var stmt: OpaquePointer?
+        let sql = "UPDATE TimeEntry SET endTime = datetime('now'), description = ?, updatedAt = datetime('now') WHERE id = ?"
+        if sqlite3_prepare_v2(db, sql, -1, &stmt, nil) == SQLITE_OK {
+            if let d = desc, !d.isEmpty {
+                sqlite3_bind_text(stmt, 1, (d as NSString).utf8String, -1, SQLITE_TRANSIENT)
+            } else {
+                sqlite3_bind_null(stmt, 1)
+            }
+            sqlite3_bind_text(stmt, 2, (entryId as NSString).utf8String, -1, SQLITE_TRANSIENT)
+            sqlite3_step(stmt)
+        }
+        sqlite3_finalize(stmt)
+
+        updateMenu()
+    }
+
+    @objc func startTimerClicked(_ sender: NSMenuItem) {
+        guard let projectId = sender.representedObject as? String else { return }
+
+        var db: OpaquePointer?
+        guard sqlite3_open(dbPath, &db) == SQLITE_OK else { return }
+        defer { sqlite3_close(db) }
+        sqlite3_exec(db, "PRAGMA journal_mode=WAL", nil, nil, nil)
+        sqlite3_busy_timeout(db, 5000)
+
+        sqlite3_exec(db, "UPDATE TimeEntry SET endTime = datetime('now'), updatedAt = datetime('now') WHERE endTime IS NULL", nil, nil, nil)
+
+        let id = UUID().uuidString.lowercased()
+        var stmt: OpaquePointer?
+        let sql = "INSERT INTO TimeEntry (id, projectId, startTime, createdAt, updatedAt) VALUES (?, ?, datetime('now'), datetime('now'), datetime('now'))"
+        if sqlite3_prepare_v2(db, sql, -1, &stmt, nil) == SQLITE_OK {
+            sqlite3_bind_text(stmt, 1, (id as NSString).utf8String, -1, SQLITE_TRANSIENT)
+            sqlite3_bind_text(stmt, 2, (projectId as NSString).utf8String, -1, SQLITE_TRANSIENT)
+            sqlite3_step(stmt)
+        }
+        sqlite3_finalize(stmt)
+
+        updateMenu()
+    }
+
+    @objc func quitApp() {
+        NSApp.terminate(nil)
+    }
+}
+
+let app = NSApplication.shared
+app.setActivationPolicy(.accessory)
+let delegate = AppDelegate()
+app.delegate = delegate
+app.run()
+`;
+}

package/src/types.ts

@@ -102,6 +102,7 @@ export interface AppSettings {
 	stripeApiKey: string;
 	timezone: string; // IANA timezone (e.g., "America/New_York") or "auto" for system detection
 	theme: string; // Theme name (e.g., "catppuccin-mocha", "neon")
+	menuBar: string; // "enabled" or "disabled"
 }
 
 // Theme color definitions