diff --git a/src/lib/ipc.ts b/src/lib/ipc.ts
index c8f7c346..f5c68c7e 100644
--- a/src/lib/ipc.ts
+++ b/src/lib/ipc.ts
@@ -7,6 +7,7 @@ declare global {
electron: {
ipcRenderer: {
invoke: (channel: string, ...args: unknown[]) => Promise
;
+ send: (channel: string, ...args: unknown[]) => void;
on: (channel: string, listener: (...args: unknown[]) => void) => () => void;
removeAllListeners: (channel: string) => void;
};
diff --git a/src/store/core.ts b/src/store/core.ts
index fb7425a9..a960a334 100644
--- a/src/store/core.ts
+++ b/src/store/core.ts
@@ -41,6 +41,7 @@ export const [store, setStore] = createStore({
windowState: null,
autoTrustFolders: false,
showPlans: true,
+ desktopNotificationsEnabled: false,
inactiveColumnOpacity: 0.6,
editorCommand: '',
newTaskDropUrl: null,
diff --git a/src/store/desktopNotifications.ts b/src/store/desktopNotifications.ts
new file mode 100644
index 00000000..3eb6a25b
--- /dev/null
+++ b/src/store/desktopNotifications.ts
@@ -0,0 +1,127 @@
+import { createEffect, onCleanup, type Accessor } from 'solid-js';
+import { store } from './store';
+import { getTaskDotStatus, type TaskDotStatus } from './taskStatus';
+import { setActiveTask } from './navigation';
+import { IPC } from '../../electron/ipc/channels';
+
+const DEBOUNCE_MS = 3_000;
+
+interface PendingNotification {
+ type: 'ready' | 'waiting';
+ taskId: string;
+}
+
+export function startDesktopNotificationWatcher(windowFocused: Accessor): () => void {
+ const previousStatus = new Map();
+ let pending: PendingNotification[] = [];
+ let debounceTimer: ReturnType | undefined;
+
+ function flushNotifications(): void {
+ debounceTimer = undefined;
+ if (windowFocused() || pending.length === 0) {
+ pending = [];
+ return;
+ }
+
+ const ready = pending.filter((n) => n.type === 'ready');
+ const waiting = pending.filter((n) => n.type === 'waiting');
+ pending = [];
+
+ if (ready.length > 0) {
+ const taskIds = ready.map((n) => n.taskId);
+ const body =
+ ready.length === 1
+ ? `${taskName(taskIds[0])} is ready for review`
+ : `${ready.length} tasks ready for review`;
+ window.electron.ipcRenderer.send(IPC.ShowNotification, {
+ title: 'Task Ready',
+ body,
+ taskIds,
+ });
+ }
+
+ if (waiting.length > 0) {
+ const taskIds = waiting.map((n) => n.taskId);
+ const body =
+ waiting.length === 1
+ ? `${taskName(taskIds[0])} needs your attention`
+ : `${waiting.length} tasks need your attention`;
+ window.electron.ipcRenderer.send(IPC.ShowNotification, {
+ title: 'Task Waiting',
+ body,
+ taskIds,
+ });
+ }
+ }
+
+ function taskName(taskId: string): string {
+ return store.tasks[taskId]?.name ?? taskId;
+ }
+
+ function scheduleBatch(notification: PendingNotification): void {
+ if (!store.desktopNotificationsEnabled) return;
+ pending.push(notification);
+ if (debounceTimer === undefined) {
+ debounceTimer = setTimeout(flushNotifications, DEBOUNCE_MS);
+ }
+ }
+
+ // Track status transitions
+ createEffect(() => {
+ const allTaskIds = [...store.taskOrder, ...store.collapsedTaskOrder];
+ const seen = new Set();
+
+ for (const taskId of allTaskIds) {
+ seen.add(taskId);
+ const current = getTaskDotStatus(taskId);
+ const prev = previousStatus.get(taskId);
+ previousStatus.set(taskId, current);
+
+ // Skip initial population
+ if (prev === undefined) continue;
+ if (prev === current) continue;
+
+ if (current === 'ready' && prev !== 'ready') {
+ scheduleBatch({ type: 'ready', taskId });
+ } else if (current === 'waiting' && prev === 'busy') {
+ scheduleBatch({ type: 'waiting', taskId });
+ }
+ }
+
+ // Clean up removed tasks
+ for (const taskId of previousStatus.keys()) {
+ if (!seen.has(taskId)) previousStatus.delete(taskId);
+ }
+ });
+
+ // Clear pending when window regains focus
+ createEffect(() => {
+ if (windowFocused()) {
+ pending = [];
+ if (debounceTimer !== undefined) {
+ clearTimeout(debounceTimer);
+ debounceTimer = undefined;
+ }
+ }
+ });
+
+ // Listen for notification clicks from main process
+ const offNotificationClicked = window.electron.ipcRenderer.on(
+ IPC.NotificationClicked,
+ (data: unknown) => {
+ const msg = data as Record;
+ const taskIds = Array.isArray(msg?.taskIds) ? (msg.taskIds as string[]) : [];
+ if (taskIds.length) {
+ setActiveTask(taskIds[0]);
+ }
+ },
+ );
+
+ const cleanup = (): void => {
+ if (debounceTimer !== undefined) clearTimeout(debounceTimer);
+ offNotificationClicked();
+ };
+
+ onCleanup(cleanup);
+ return cleanup;
+}
diff --git a/src/store/persistence.ts b/src/store/persistence.ts
index dfe4babf..595d6701 100644
--- a/src/store/persistence.ts
+++ b/src/store/persistence.ts
@@ -40,6 +40,7 @@ export async function saveState(): Promise {
windowState: store.windowState ? { ...store.windowState } : undefined,
autoTrustFolders: store.autoTrustFolders,
showPlans: store.showPlans,
+ desktopNotificationsEnabled: store.desktopNotificationsEnabled,
inactiveColumnOpacity: store.inactiveColumnOpacity,
editorCommand: store.editorCommand || undefined,
customAgents: store.customAgents.length > 0 ? [...store.customAgents] : undefined,
@@ -171,6 +172,7 @@ interface LegacyPersistedState {
windowState?: unknown;
autoTrustFolders?: unknown;
showPlans?: unknown;
+ desktopNotificationsEnabled?: unknown;
inactiveColumnOpacity?: unknown;
editorCommand?: unknown;
customAgents?: unknown;
@@ -269,6 +271,10 @@ export async function loadState(): Promise {
s.windowState = parsePersistedWindowState(raw.windowState);
s.autoTrustFolders = typeof raw.autoTrustFolders === 'boolean' ? raw.autoTrustFolders : false;
s.showPlans = typeof raw.showPlans === 'boolean' ? raw.showPlans : true;
+ s.desktopNotificationsEnabled =
+ typeof raw.desktopNotificationsEnabled === 'boolean'
+ ? raw.desktopNotificationsEnabled
+ : false;
const rawOpacity = raw.inactiveColumnOpacity;
s.inactiveColumnOpacity =
typeof rawOpacity === 'number' &&
diff --git a/src/store/store.ts b/src/store/store.ts
index af9079d5..aeee5da9 100644
--- a/src/store/store.ts
+++ b/src/store/store.ts
@@ -96,6 +96,7 @@ export {
setThemePreset,
setAutoTrustFolders,
setShowPlans,
+ setDesktopNotificationsEnabled,
setInactiveColumnOpacity,
setEditorCommand,
setWindowState,
diff --git a/src/store/types.ts b/src/store/types.ts
index 6a5649b2..914ec4a5 100644
--- a/src/store/types.ts
+++ b/src/store/types.ts
@@ -114,6 +114,7 @@ export interface PersistedState {
windowState?: PersistedWindowState;
autoTrustFolders?: boolean;
showPlans?: boolean;
+ desktopNotificationsEnabled?: boolean;
inactiveColumnOpacity?: number;
editorCommand?: string;
customAgents?: AgentDef[];
@@ -176,6 +177,7 @@ export interface AppStore {
windowState: PersistedWindowState | null;
autoTrustFolders: boolean;
showPlans: boolean;
+ desktopNotificationsEnabled: boolean;
inactiveColumnOpacity: number;
editorCommand: string;
newTaskDropUrl: string | null;
diff --git a/src/store/ui.ts b/src/store/ui.ts
index a50a3e8f..4b23474d 100644
--- a/src/store/ui.ts
+++ b/src/store/ui.ts
@@ -87,6 +87,10 @@ export function setShowPlans(showPlans: boolean): void {
setStore('showPlans', showPlans);
}
+export function setDesktopNotificationsEnabled(enabled: boolean): void {
+ setStore('desktopNotificationsEnabled', enabled);
+}
+
export function setInactiveColumnOpacity(opacity: number): void {
setStore('inactiveColumnOpacity', Math.round(Math.max(0.3, Math.min(1.0, opacity)) * 100) / 100);
}