pacatui 0.1.14 → 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.14",
+  "version": "0.1.15",
   "description": "A simple tui app for task, timer and invoicing for projects.",
   "module": "src/index.tsx",
   "type": "module",

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

@@ -185,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

@@ -4,10 +4,16 @@ import { homedir } from "os";
 
 const DB_PATH = join(homedir(), ".paca", "paca.db");
 
-function openDb(): Database {
+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 journal_mode=WAL");
   db.exec("PRAGMA busy_timeout=5000");
+  db.exec("PRAGMA journal_mode=WAL");
   return db;
 }
 
@@ -17,6 +23,7 @@ export interface RunningTimerRow {
   projectId: string;
   projectName: string;
   projectColor: string;
+  projectHourlyRate: number | null;
 }
 
 export interface ProjectRow {
@@ -26,12 +33,13 @@ export interface ProjectRow {
 }
 
 export function getRunningTimer(): RunningTimerRow | null {
-  const db = openDb();
+  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.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
@@ -45,7 +53,7 @@ export function getRunningTimer(): RunningTimerRow | null {
 }
 
 export function getProjects(): ProjectRow[] {
-  const db = openDb();
+  const db = openReadonly();
   try {
     return db
       .query<ProjectRow, []>(
@@ -58,7 +66,7 @@ export function getProjects(): ProjectRow[] {
 }
 
 export function startTimer(projectId: string): void {
-  const db = openDb();
+  const db = openReadWrite();
   try {
     // Stop any running timer first
     const running = db
@@ -84,7 +92,7 @@ export function startTimer(projectId: string): void {
 }
 
 export function stopTimer(entryId: string, description?: string): void {
-  const db = openDb();
+  const db = openReadWrite();
   try {
     db.query(
       `UPDATE TimeEntry SET endTime = datetime('now'), description = ?, updatedAt = datetime('now') WHERE id = ?`,

package/src/menubar/index.ts

@@ -1,143 +1,201 @@
-import { existsSync, writeFileSync, unlinkSync, chmodSync } from "fs";
-import { join } from "path";
+import { existsSync, writeFileSync, unlinkSync, readFileSync } from "fs";
+import { join, dirname } from "path";
 import { homedir } from "os";
-import { execSync } from "child_process";
-import { getPluginScript } from "./plugin.ts";
-import { getActionScript } from "./action.ts";
+import { execSync, spawn } from "child_process";
+import { getSwiftSource } from "./swift-source.ts";
 import { getRunningTimer, getProjects } from "./db-lite.ts";
 
-const PLUGIN_FILENAME = "paca-timer.3s.ts";
-const ACTION_FILENAME = "menubar-action.ts";
 const PACA_DIR = join(homedir(), ".paca");
-const ACTION_PATH = join(PACA_DIR, ACTION_FILENAME);
+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 resolveBunPath(): string {
+function hasSwiftCompiler(): boolean {
   try {
-    return execSync("which bun", { encoding: "utf-8" }).trim();
+    execSync("which swiftc", { encoding: "utf-8", stdio: "pipe" });
+    return true;
   } catch {
-    throw new Error("Could not find bun in PATH. Is Bun installed?");
+    return false;
   }
 }
 
-function findSwiftBarPluginDir(): string | null {
-  // Try reading from SwiftBar defaults
+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 {
-    const dir = execSync(
-      "defaults read com.ameba.SwiftBar PluginDirectory 2>/dev/null",
-      { encoding: "utf-8" },
-    ).trim();
-    if (dir && existsSync(dir)) return dir;
+    // 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 {
-    // ignore
+    return "";
   }
+}
 
-  // Check common locations
-  const candidates = [
-    join(homedir(), "Library", "Application Support", "SwiftBar", "Plugins"),
-    join(homedir(), ".swiftbar"),
-  ];
+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;
+  }
+}
 
-  for (const dir of candidates) {
-    if (existsSync(dir)) return dir;
+function readPid(): number | null {
+  try {
+    const pid = parseInt(readFileSync(PID_PATH, "utf-8").trim(), 10);
+    return isNaN(pid) ? null : pid;
+  } catch {
+    return null;
   }
+}
 
-  return null;
+function isProcessRunning(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
 }
 
-function isSwiftBarInstalled(): boolean {
-  return (
-    existsSync("/Applications/SwiftBar.app") ||
-    existsSync(join(homedir(), "Applications", "SwiftBar.app"))
-  );
+export function isMenuBarRunning(): boolean {
+  const pid = readPid();
+  return pid !== null && isProcessRunning(pid);
 }
 
-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")}`;
+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;
 }
 
-async function install() {
-  if (!isSwiftBarInstalled()) {
-    console.log("SwiftBar is not installed.");
-    console.log("");
-    console.log("Install it with:");
-    console.log("  brew install --cask swiftbar");
-    console.log("");
-    console.log("Then run this command again:");
-    console.log("  paca menubar install");
-    process.exit(1);
+function killHelper(): boolean {
+  const pid = readPid();
+  if (pid === null) return false;
+
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch {
+    // Process already gone
   }
 
-  const pluginDir = findSwiftBarPluginDir();
-  if (!pluginDir) {
-    console.log("Could not find SwiftBar plugin directory.");
-    console.log("");
-    console.log("Make sure SwiftBar has been launched at least once,");
-    console.log("or set a plugin directory in SwiftBar preferences.");
-    process.exit(1);
+  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.";
   }
 
-  const bunPath = resolveBunPath();
-  const pluginPath = join(pluginDir, PLUGIN_FILENAME);
+  if (!hasSwiftCompiler()) {
+    return "Xcode Command Line Tools required. Install with: xcode-select --install";
+  }
 
-  // Write plugin script
-  writeFileSync(pluginPath, getPluginScript(bunPath), "utf-8");
-  chmodSync(pluginPath, 0o755);
+  // Compile if binary doesn't exist
+  if (!existsSync(BINARY_PATH)) {
+    const ok = compileBinary();
+    if (!ok) return "Failed to compile menu bar helper.";
+  }
 
-  // Write action script
-  writeFileSync(ACTION_PATH, getActionScript(bunPath), "utf-8");
-  chmodSync(ACTION_PATH, 0o755);
+  const launched = launchHelper();
+  if (!launched) return "Failed to launch menu bar helper.";
 
-  console.log("Paca menu bar plugin installed!");
-  console.log("");
-  console.log(`  Plugin: ${pluginPath}`);
-  console.log(`  Action: ${ACTION_PATH}`);
-  console.log("");
-  console.log("The timer should appear in your menu bar shortly.");
-  console.log("If not, open SwiftBar and refresh plugins.");
+  return "Menu bar enabled.";
 }
 
-async function uninstall() {
-  let removed = false;
+/**
+ * Disable the menu bar helper. Called from settings toggle or CLI.
+ * Returns a status message string.
+ */
+export async function disableMenuBar(): Promise<string> {
+  killHelper();
 
-  // Remove plugin
-  const pluginDir = findSwiftBarPluginDir();
-  if (pluginDir) {
-    const pluginPath = join(pluginDir, PLUGIN_FILENAME);
-    if (existsSync(pluginPath)) {
-      unlinkSync(pluginPath);
-      console.log(`Removed plugin: ${pluginPath}`);
-      removed = true;
-    }
-  }
+  // Remove binary
+  if (existsSync(BINARY_PATH)) unlinkSync(BINARY_PATH);
 
-  // Remove action script
-  if (existsSync(ACTION_PATH)) {
-    unlinkSync(ACTION_PATH);
-    console.log(`Removed action script: ${ACTION_PATH}`);
-    removed = true;
-  }
+  return "Menu bar disabled.";
+}
 
-  if (removed) {
-    console.log("");
-    console.log("Paca menu bar plugin uninstalled.");
-  } else {
-    console.log("No menu bar plugin files found to remove.");
-  }
+/**
+ * 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);
 }
 
-function status() {
-  const DB_PATH = join(PACA_DIR, "paca.db");
-  if (!existsSync(DB_PATH)) {
+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);
@@ -146,64 +204,37 @@ function status() {
     console.log("No timer running.");
   }
 
-  const projects = getProjects();
-  if (projects.length > 0) {
+  const allProjects = getProjects();
+  if (allProjects.length > 0) {
     console.log("");
     console.log("Projects:");
-    for (const p of projects) {
+    for (const p of allProjects) {
       console.log(`  - ${p.name}`);
     }
   }
 }
 
 function showHelp() {
-  const running = getRunningTimer();
-  if (running) {
-    const elapsed = formatElapsed(running.startTime);
-    console.log(`Timer: ${running.projectName} (${elapsed})`);
-  } else {
-    console.log("No timer running.");
-  }
-
-  console.log("");
   console.log("Menu bar commands:");
-  console.log("  paca menubar install    Install SwiftBar plugin");
-  console.log("  paca menubar uninstall  Remove SwiftBar plugin");
-  console.log("  paca menubar status     Show current timer status");
+  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("");
-
-  if (!isSwiftBarInstalled()) {
-    console.log("SwiftBar is not installed. Install it with:");
-    console.log("  brew install --cask swiftbar");
-  } else {
-    const pluginDir = findSwiftBarPluginDir();
-    if (pluginDir) {
-      const pluginPath = join(pluginDir, PLUGIN_FILENAME);
-      if (existsSync(pluginPath)) {
-        console.log("Status: Plugin installed");
-      } else {
-        console.log("Status: SwiftBar found, plugin not installed");
-        console.log("  Run: paca menubar install");
-      }
-    } else {
-      console.log("Status: SwiftBar found, but no plugin directory set");
-      console.log("  Launch SwiftBar first, then run: paca menubar install");
-    }
-  }
+  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[]) {
-  const subcommand = args[0];
-
-  switch (subcommand) {
-    case "install":
-      await install();
+  switch (args[0]) {
+    case "enable":
+      await cliEnable();
       break;
-    case "uninstall":
-      await uninstall();
+    case "disable":
+      await cliDisable();
       break;
     case "status":
-      status();
+      cliStatus();
       break;
     default:
       showHelp();

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

package/src/menubar/action.ts

@@ -1,80 +0,0 @@
-import { join } from "path";
-import { homedir } from "os";
-
-/**
- * Returns the content of the action handler script.
- * This script is invoked by SwiftBar when the user clicks a menu item.
- */
-export function getActionScript(bunPath: string): string {
-  const dbPath = join(homedir(), ".paca", "paca.db");
-
-  return `#!${bunPath}
-// Paca SwiftBar Action Handler — auto-generated, do not edit
-
-import Database from "bun:sqlite";
-
-const DB_PATH = ${JSON.stringify(dbPath)};
-
-function openDb() {
-  const db = new Database(DB_PATH);
-  db.exec("PRAGMA journal_mode=WAL");
-  db.exec("PRAGMA busy_timeout=5000");
-  return db;
-}
-
-async function askDescription(): Promise<string> {
-  try {
-    const proc = Bun.spawnSync([
-      "osascript", "-e",
-      'display dialog "What did you work on?" default answer "" with title "Paca — Stop Timer" buttons {"Cancel", "Save"} default button "Save"',
-    ]);
-    const output = proc.stdout.toString().trim();
-    // osascript returns: "button returned:Save, text returned:my description"
-    const match = output.match(/text returned:(.*)/);
-    return match?.[1]?.trim() ?? "";
-  } catch {
-    return "";
-  }
-}
-
-async function main() {
-  const action = process.argv[2];
-  const id = process.argv[3];
-
-  if (!action || !id) {
-    console.error("Usage: action.ts <start|stop> <id>");
-    process.exit(1);
-  }
-
-  const db = openDb();
-
-  try {
-    if (action === "stop") {
-      const description = await askDescription();
-      db.query(
-        \`UPDATE TimeEntry SET endTime = datetime('now'), description = ?, updatedAt = datetime('now') WHERE id = ?\`
-      ).run(description || null, id);
-    } else if (action === "start") {
-      // Stop any running timer first
-      const running = db.query("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 newId = crypto.randomUUID();
-      db.query(
-        \`INSERT INTO TimeEntry (id, projectId, startTime, createdAt, updatedAt)
-         VALUES (?, ?, datetime('now'), datetime('now'), datetime('now'))\`
-      ).run(newId, id);
-    }
-  } finally {
-    db.close();
-  }
-}
-
-main();
-`;
-}

package/src/menubar/plugin.ts

@@ -1,88 +0,0 @@
-import { join } from "path";
-import { homedir } from "os";
-
-/**
- * Returns the content of the SwiftBar plugin script.
- * The script is a self-contained Bun script that reads the Paca DB
- * and outputs SwiftBar-formatted text.
- */
-export function getPluginScript(bunPath: string): string {
-  const dbPath = join(homedir(), ".paca", "paca.db");
-  const actionPath = join(homedir(), ".paca", "menubar-action.ts");
-
-  return `#!${bunPath}
-// Paca SwiftBar Plugin — auto-generated, do not edit
-// Refresh: every 3 seconds (from filename)
-
-import Database from "bun:sqlite";
-
-const DB_PATH = ${JSON.stringify(dbPath)};
-const ACTION = ${JSON.stringify(actionPath)};
-const BUN = ${JSON.stringify(bunPath)};
-
-function main() {
-  let db;
-  try {
-    db = new Database(DB_PATH, { readonly: true });
-    db.exec("PRAGMA busy_timeout=5000");
-  } catch {
-    console.log("⏸ Paca | color=#6c7086");
-    console.log("---");
-    console.log("Database not found | color=#f38ba8");
-    console.log("Run paca to initialize | color=#6c7086");
-    return;
-  }
-
-  try {
-    // Check for running timer
-    const running = db
-      .query(
-        \`SELECT te.id, te.startTime, p.name AS projectName, p.color AS projectColor
-         FROM TimeEntry te
-         JOIN Project p ON p.id = te.projectId
-         WHERE te.endTime IS NULL
-         LIMIT 1\`
-      )
-      .get();
-
-    if (running) {
-      // Calculate elapsed time
-      const startMs = new Date(running.startTime + "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;
-      const elapsed = \`\${h}:\${String(m).padStart(2, "0")}:\${String(s).padStart(2, "0")}\`;
-
-      console.log(\`▶ \${running.projectName} \${elapsed} | color=#a6e3a1 sfimage=timer\`);
-      console.log("---");
-      console.log(\`Stop Timer | bash=\${BUN} param1=\${ACTION} param2=stop param3=\${running.id} terminal=false refresh=true\`);
-    } else {
-      console.log("⏸ Paca | color=#6c7086 sfimage=timer");
-    }
-
-    console.log("---");
-
-    // List projects
-    const projects = db
-      .query("SELECT id, name, color FROM Project WHERE archived = 0 ORDER BY name ASC")
-      .all();
-
-    if (projects.length === 0) {
-      console.log("No projects yet | color=#6c7086");
-      console.log("Open paca to create one | color=#6c7086");
-    } else {
-      console.log("Start Timer For... | disabled=true color=#6c7086");
-      for (const p of projects) {
-        console.log(\`\${p.name} | bash=\${BUN} param1=\${ACTION} param2=start param3=\${p.id} terminal=false refresh=true color=\${p.color}\`);
-      }
-    }
-  } finally {
-    db.close();
-  }
-}
-
-main();
-`;
-}