claude-status-menubar 1.0.0

package/README.md

@@ -0,0 +1,41 @@
+# claude-status-menubar
+
+macOS menu bar app showing live status of Claude Desktop (Cowork) sessions —
+**✳ Running / Done / Idle** — with a notification when a session finishes.
+Compiles locally on install (no Gatekeeper warnings, nothing to notarize).
+
+## Install (end users)
+
+```bash
+npx claude-status-menubar
+```
+
+Requirements: macOS, Claude Desktop, Xcode Command Line Tools
+(`xcode-select --install` if the installer says the compiler is missing).
+
+Installs `~/Applications/Claude Status.app` + a LaunchAgent for auto-start at
+login. The ✳ icon appears near the right side of the menu bar (pinned right of
+the notch; Cmd-drag to move it).
+
+## Uninstall
+
+```bash
+launchctl bootout "gui/$(id -u)/com.claude-status.menubar"
+rm -rf ~/Applications/"Claude Status.app" ~/Library/LaunchAgents/com.claude-status.menubar.plist
+defaults delete com.claude-status.menubar 2>/dev/null
+```
+
+## Publishing (for the maintainer — one-time setup)
+
+1. `cd` into this folder.
+2. `npm login` (create a free account at npmjs.com if needed).
+3. `npm publish` — if the name `claude-status-menubar` is taken, rename in
+   `package.json` to a scoped name like `@yourusername/claude-status-menubar`
+   and publish with `npm publish --access public`. Users then run
+   `npx @yourusername/claude-status-menubar`.
+4. Future updates: bump `version` in package.json, `npm publish` again.
+
+No-npm alternative: push this folder to GitHub and share
+`curl -fsSL https://raw.githubusercontent.com/<user>/<repo>/main/assets/build_install.sh` —
+but users also need `ClaudeStatus.swift` next to it, so for curl distribution
+point people at `git clone` + `bash assets/build_install.sh` instead.

package/assets/ClaudeStatus.swift

@@ -0,0 +1,217 @@
+// Claude Status — menu bar tracker for Claude Desktop (Cowork) sessions.
+// Polls ~/Library/Application Support/Claude/local-agent-mode-sessions/ every few
+// seconds. A session whose files were written within `quietThreshold` seconds is
+// "running"; when a running session goes quiet, a macOS notification fires.
+//
+// Build/install: ./build_install.sh   (installs to ~/Applications/Claude Status.app)
+
+import AppKit
+import Foundation
+
+struct Session {
+    let id: String
+    let title: String
+    let lastActivity: Date
+    let isArchived: Bool
+}
+
+final class SessionScanner {
+    let root = NSString(string: "~/Library/Application Support/Claude/local-agent-mode-sessions").expandingTildeInPath
+    private var titleCache: [String: (mtime: Date, title: String, archived: Bool)] = [:]
+
+    func scan() -> [Session] {
+        let fm = FileManager.default
+        var sessions: [Session] = []
+        guard let level1 = try? fm.contentsOfDirectory(atPath: root) else { return [] }
+        for d1 in level1 {
+            let p1 = root + "/" + d1
+            var isDir: ObjCBool = false
+            guard fm.fileExists(atPath: p1, isDirectory: &isDir), isDir.boolValue else { continue }
+            guard let level2 = try? fm.contentsOfDirectory(atPath: p1) else { continue }
+            for d2 in level2 {
+                let p2 = p1 + "/" + d2
+                guard fm.fileExists(atPath: p2, isDirectory: &isDir), isDir.boolValue else { continue }
+                guard let files = try? fm.contentsOfDirectory(atPath: p2) else { continue }
+                for f in files where f.hasPrefix("local_") && f.hasSuffix(".json") {
+                    let jsonPath = p2 + "/" + f
+                    let id = String(f.dropLast(5)) // strip ".json"
+                    guard let attrs = try? fm.attributesOfItem(atPath: jsonPath),
+                          var mtime = attrs[.modificationDate] as? Date else { continue }
+                    // The audit log also updates on every tool call — use whichever is fresher.
+                    let auditPath = p2 + "/" + id + "/audit.jsonl"
+                    if let a = try? fm.attributesOfItem(atPath: auditPath),
+                       let am = a[.modificationDate] as? Date, am > mtime {
+                        mtime = am
+                    }
+                    let meta = titleFor(id: id, path: jsonPath, mtime: mtime)
+                    sessions.append(Session(id: id, title: meta.0, lastActivity: mtime, isArchived: meta.1))
+                }
+            }
+        }
+        return sessions.sorted { $0.lastActivity > $1.lastActivity }
+    }
+
+    private func titleFor(id: String, path: String, mtime: Date) -> (String, Bool) {
+        if let c = titleCache[id], c.mtime == mtime { return (c.title, c.archived) }
+        var title = "Untitled session"
+        var archived = false
+        if let data = FileManager.default.contents(atPath: path),
+           let obj = (try? JSONSerialization.jsonObject(with: data)) as? [String: Any] {
+            title = (obj["title"] as? String)
+                ?? (obj["initialMessage"] as? String)
+                ?? title
+            archived = (obj["isArchived"] as? Bool) ?? false
+        }
+        titleCache[id] = (mtime, title, archived)
+        return (title, archived)
+    }
+}
+
+final class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate {
+    private let scanner = SessionScanner()
+    private var statusItem: NSStatusItem!
+    private let menu = NSMenu()
+    private var timer: Timer?
+    private var runningIDs: Set<String> = []
+    private var latest: [Session] = []
+
+    /// Seconds with no file writes before a session counts as finished.
+    /// (Long tool calls can be quiet for ~45s, so don't set this too low.)
+    private let quietThreshold: TimeInterval = 45
+    private let pollInterval: TimeInterval = 3
+    /// How long the menu bar shows "Done" after the last session finishes.
+    private let doneHold: TimeInterval = 300
+    private var lastFinishAt: Date?
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        NSLog("ClaudeStatus: didFinishLaunching")
+        // Single instance guard. Note: LaunchServices can briefly keep stale
+        // entries for a just-killed instance, so verify the pid is actually
+        // alive (kill(pid, 0)) before yielding — and use exit(), because
+        // NSApp.terminate() is silently swallowed during launch.
+        let myPid = ProcessInfo.processInfo.processIdentifier
+        if let bid = Bundle.main.bundleIdentifier {
+            let others = NSRunningApplication.runningApplications(withBundleIdentifier: bid)
+                .filter { $0.processIdentifier != myPid && kill($0.processIdentifier, 0) == 0 }
+            if !others.isEmpty {
+                NSLog("ClaudeStatus: live duplicate instance found — exiting")
+                exit(0)
+            }
+        }
+        statusItem = NSStatusBar.system.statusItem(withLength: NSStatusItem.variableLength)
+        // Persist position (defaults key "NSStatusItem Preferred Position ClaudeStatus").
+        // Seeded by build_install.sh to sit right of the notch on notched MacBooks —
+        // without this, new items spawn leftmost and can be hidden under the notch.
+        statusItem.autosaveName = "ClaudeStatus"
+        NSLog("ClaudeStatus: status item created, button=%@", statusItem.button == nil ? "nil" : "ok")
+        if let button = statusItem.button {
+            // Text-only: an SF Symbol image can fail to load and leave a
+            // zero-width (invisible) status item. Text always renders.
+            button.title = "\u{2733}"  // ✳
+        }
+        menu.delegate = self
+        statusItem.menu = menu
+        refresh()
+        timer = Timer.scheduledTimer(withTimeInterval: pollInterval, repeats: true) { [weak self] _ in
+            self?.refresh()
+        }
+    }
+
+    private func refresh() {
+        let sessions = scanner.scan().filter { !$0.isArchived }
+        latest = sessions
+        let now = Date()
+        let nowRunning = Set(
+            sessions.filter { now.timeIntervalSince($0.lastActivity) < quietThreshold }.map { $0.id }
+        )
+        let finished = runningIDs.subtracting(nowRunning)
+        for id in finished {
+            if let s = sessions.first(where: { $0.id == id }) {
+                notifyDone(s)
+            }
+        }
+        if !finished.isEmpty { lastFinishAt = now }
+        runningIDs = nowRunning
+        updateButton(running: nowRunning.count, now: now)
+    }
+
+    private func updateButton(running: Int, now: Date) {
+        guard let button = statusItem.button else { return }
+        let state: String
+        if running > 0 {
+            state = running > 1 ? "Running \(running)" : "Running"
+        } else if let t = lastFinishAt, now.timeIntervalSince(t) < doneHold {
+            state = "Done"
+        } else {
+            state = "Idle"
+        }
+        let font = NSFont.systemFont(ofSize: 14, weight: .medium)
+        let terracotta = NSColor(srgbRed: 0.85, green: 0.47, blue: 0.34, alpha: 1.0)  // Claude brand-ish
+        let title = NSMutableAttributedString()
+        title.append(NSAttributedString(string: "\u{2733} ",
+                                        attributes: [.font: font, .foregroundColor: terracotta]))
+        title.append(NSAttributedString(string: state,
+                                        attributes: [.font: font, .foregroundColor: NSColor.labelColor]))
+        button.attributedTitle = title
+    }
+
+    private func notifyDone(_ s: Session) {
+        let safeTitle = s.title
+            .replacingOccurrences(of: "\\", with: "")
+            .replacingOccurrences(of: "\"", with: "'")
+        let script = "display notification \"\(safeTitle)\" with title \"Claude — session finished\" sound name \"Glass\""
+        let p = Process()
+        p.executableURL = URL(fileURLWithPath: "/usr/bin/osascript")
+        p.arguments = ["-e", script]
+        try? p.run()
+    }
+
+    // MARK: - Menu
+
+    func menuNeedsUpdate(_ menu: NSMenu) {
+        menu.removeAllItems()
+        let now = Date()
+        let recent = latest.filter { now.timeIntervalSince($0.lastActivity) < 48 * 3600 }
+        let shown = recent.isEmpty ? Array(latest.prefix(5)) : Array(recent.prefix(10))
+
+        if shown.isEmpty {
+            menu.addItem(NSMenuItem(title: "No Claude sessions found", action: nil, keyEquivalent: ""))
+        }
+        for s in shown {
+            let running = runningIDs.contains(s.id)
+            let mark = running ? "\u{25CF} " : "\u{25CB} "  // ● / ○
+            let when = running ? "running" : relative(now.timeIntervalSince(s.lastActivity))
+            let item = NSMenuItem(title: "\(mark)\(truncate(s.title, 42)) — \(when)",
+                                  action: #selector(openClaude), keyEquivalent: "")
+            item.target = self
+            menu.addItem(item)
+        }
+        menu.addItem(.separator())
+        let open = NSMenuItem(title: "Open Claude", action: #selector(openClaude), keyEquivalent: "o")
+        open.target = self
+        menu.addItem(open)
+        menu.addItem(NSMenuItem(title: "Quit Claude Status",
+                                action: #selector(NSApplication.terminate(_:)), keyEquivalent: "q"))
+    }
+
+    @objc private func openClaude() {
+        NSWorkspace.shared.open(URL(fileURLWithPath: "/Applications/Claude.app"))
+    }
+
+    private func relative(_ t: TimeInterval) -> String {
+        if t < 90 { return "just now" }
+        if t < 3600 { return "\(Int(t / 60))m ago" }
+        if t < 86400 { return "\(Int(t / 3600))h ago" }
+        return "\(Int(t / 86400))d ago"
+    }
+
+    private func truncate(_ s: String, _ n: Int) -> String {
+        s.count <= n ? s : String(s.prefix(n - 1)) + "\u{2026}"
+    }
+}
+
+let app = NSApplication.shared
+let delegate = AppDelegate()
+app.delegate = delegate
+app.setActivationPolicy(.accessory)
+app.run()

package/assets/build_install.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+# Build "Claude Status" menu bar app, install to ~/Applications, register auto-start.
+# Safe to re-run: rebuilds and replaces the existing install.
+# Touches ONLY: ~/Applications/Claude Status.app and
+#               ~/Library/LaunchAgents/com.claude-status.menubar.plist
+set -euo pipefail
+
+SRC_DIR="$(cd "$(dirname "$0")" && pwd)"
+APP="$HOME/Applications/Claude Status.app"
+BUILD="$SRC_DIR/.build"
+LABEL="com.claude-status.menubar"
+LA="$HOME/Library/LaunchAgents/$LABEL.plist"
+
+if ! xcrun swiftc --version >/dev/null 2>&1; then
+    echo "ERROR: Swift compiler not found. Install Xcode Command Line Tools first:"
+    echo "    xcode-select --install"
+    exit 1
+fi
+
+mkdir -p "$BUILD" "$HOME/Applications" "$HOME/Library/LaunchAgents"
+
+echo "== Compiling..."
+xcrun swiftc -O -o "$BUILD/ClaudeStatus" "$SRC_DIR/ClaudeStatus.swift" -framework AppKit
+
+echo "== Stopping any existing instance..."
+launchctl bootout "gui/$(id -u)/$LABEL" 2>/dev/null || true
+pkill -x ClaudeStatus 2>/dev/null || true
+sleep 1
+
+echo "== Bundling..."
+rm -rf "$APP"
+mkdir -p "$APP/Contents/MacOS"
+cp "$BUILD/ClaudeStatus" "$APP/Contents/MacOS/ClaudeStatus"
+cat > "$APP/Contents/Info.plist" <<'PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleIdentifier</key><string>com.claude-status.menubar</string>
+    <key>CFBundleName</key><string>Claude Status</string>
+    <key>CFBundleExecutable</key><string>ClaudeStatus</string>
+    <key>CFBundlePackageType</key><string>APPL</string>
+    <key>CFBundleShortVersionString</key><string>1.0</string>
+    <key>LSUIElement</key><true/>
+    <key>NSHighResolutionCapable</key><true/>
+</dict>
+</plist>
+PLIST
+codesign --force -s - "$APP"
+
+# On notched MacBooks new menu bar items spawn leftmost and can be hidden
+# under the notch. Pin the item 500pt from the right edge (user can Cmd-drag
+# it afterwards; the position persists). Only seed if not already set.
+echo "== Seeding menu bar position (right of the notch), if not already set..."
+defaults read "$LABEL" "NSStatusItem Preferred Position ClaudeStatus" >/dev/null 2>&1 || \
+    defaults write "$LABEL" "NSStatusItem Preferred Position ClaudeStatus" -float 500
+
+echo "== Registering LaunchAgent (auto-start at login)..."
+cat > "$LA" <<PLIST
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key><string>$LABEL</string>
+    <key>Program</key><string>$APP/Contents/MacOS/ClaudeStatus</string>
+    <key>RunAtLoad</key><true/>
+    <key>KeepAlive</key><false/>
+</dict>
+</plist>
+PLIST
+launchctl bootstrap "gui/$(id -u)" "$LA"
+
+sleep 2
+if pgrep -x ClaudeStatus > /dev/null; then
+    echo "== OK: Claude Status is running — look for the ✳ near the right side of your menu bar."
+else
+    echo "== WARNING: app did not start; run manually: open '$APP'"
+    exit 1
+fi

package/bin/cli.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// Installer entry point for `npx claude-status-menubar`.
+// Compiles the Swift menu bar app locally and installs it to ~/Applications
+// with a LaunchAgent for auto-start. See assets/build_install.sh for details.
+
+const { spawnSync } = require("child_process");
+const path = require("path");
+
+if (process.platform !== "darwin") {
+  console.error("Claude Status is a macOS menu bar app — this installer only runs on macOS.");
+  process.exit(1);
+}
+
+const script = path.join(__dirname, "..", "assets", "build_install.sh");
+const result = spawnSync("bash", [script], { stdio: "inherit" });
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "claude-status-menubar",
+  "version": "1.0.0",
+  "description": "macOS menu bar app showing live status of Claude Desktop (Cowork) sessions — ✳ Running / Done / Idle — with a notification when a session finishes. Compiles locally, no Gatekeeper friction.",
+  "bin": {
+    "claude-status-menubar": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "assets"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "keywords": [
+    "claude",
+    "menubar",
+    "macos",
+    "status",
+    "notifications",
+    "anthropic",
+    "cowork"
+  ],
+  "author": "Trevor Luong",
+  "license": "MIT"
+}