Lock Time

Quietly tracks how long your Mac stays locked and how long you stay focused between unlocks.

Mai Yang

28 Installs

Install Extension

Overview

Lock Time

Quietly tracks how long your Mac stays locked — and how long you stay focused between unlocks.

Features

Today Locked Time — Cumulative lock duration for today, press Enter to view session breakdown
Today Lock Sessions — Drill down to see each lock session's time range and duration
Last Lock Duration — How long your last lock session lasted, with time range (e.g. 12:57 → 13:48)
Last Unlock Interval — How long you worked continuously between unlocks
Menu Bar — Real-time lock time displayed in your menu bar with time range info
Zero Config — Works immediately after installation, no setup required
Local-First — All data stored locally, nothing leaves your Mac
Fast — First load in under 0.5s, cached loads under 0.1s

Commands

Command	Type	Description
Lock Stats	View	View today's lock time statistics
Update Lock State	Background	Automatically detects and updates lock state every 60 seconds
Lock Time Menu Bar	Menu Bar	Shows today's cumulative lock time in the menu bar

How It Works

Lock Time checks your Mac's lock state every 60 seconds using a multi-level detection strategy:

Swift + CGSessionCopyCurrentDictionary (primary) — Queries the CoreGraphics system API directly for the CGSSessionScreenIsLocked field. No extra permissions needed. Most reliable on macOS 13+.
AppleScript frontmost process detection (fallback) — Infers lock state by checking if the frontmost process is loginwindow or ScreenSaverEngine.
Gap Detection (safety net) — When the polling interval exceeds the expected threshold (>90s), infers that the Mac was locked during the gap.

If detection fails, the extension preserves the last known state rather than guessing.

Actions

Refresh (Cmd+R) — Refresh statistics
Copy Stats — Copy all stats to clipboard
Diagnostics (Cmd+T) — Run real-time detection diagnostics
Manual Update (Cmd+U) — Force a state update
Reset Today — Reset today's statistics
Reset All Data — Clear all stored data

Data Privacy

All data is stored exclusively in Raycast LocalStorage
No network requests are made — ever
No account or sign-in required
Uninstalling the extension removes all data completely

Versions4

Session History & Time Range - March 2, 2026

Added lock time range display for Last Lock Duration (e.g. 12:57 → 13:48)
Shows lock start/end time alongside the duration, no more mental math to recall when the lock happened
Added Today Lock Sessions drill-down detail view
Press Enter on Today Locked Time to see each session's time range and duration
Provides full visibility into work/rest rhythm throughout the day
Menu Bar now displays time range info for last lock session
Added LockSession data structure (lockAt / unlockAt / durationMs) and extended MetricsData with session tracking fields
State machine records complete session on LOCKED→UNLOCKED transition, with cross-midnight splitting
Added formatTime() / formatTimeRange() formatting utilities
Added SessionDetailView component with Action.Push drill-down interaction
Backward compatible: automatically fills default values for missing new fields in old data

Performance Optimization - March 2, 2026

Improved first-screen loading speed by 83% (from ~3s to ~0.5s)
Cache hit speed improved by 97% (repeated opens within 5s take <0.1s)
useLockData Hook: display cached data first, detect in background
detectLockStateWithInfo(): added 5-second detection result cache with skipCache param
processStateChange(): parallelized LocalStorage read/write, conditional writes reduce unnecessary I/O
Manual diagnosis (Cmd+T) forces cache skip for real-time status

Fixed Lock Detection on macOS 26 - March 2, 2026

Fixed lock detection completely broken on macOS 26
JXA ObjC bridge cannot properly bridge CFDictionary, causing CGSSessionScreenIsLocked field to be lost
Switched to native Swift CGSessionCopyCurrentDictionary() call for reliable bridging
Fixed AppleScript detection defaulting to "unlocked" on failure
Now preserves last known state instead of defaulting to unlocked
Fixed Lock Stats not triggering state machine on open
useLockData() now executes processStateChange() on first load
Upgraded detection to multi-level fallback: Swift CGSession → AppleScript → Gap Detection
Background no-view command logs now use fs.appendFileSync() to prevent async log loss

Initial Version - March 2, 2026

Core lock time tracking
Today Locked Time: cumulative lock duration for today
Last Lock Duration: duration of the most recent lock session
Last Unlock Interval: continuous work time between unlocks
Three usage modes
Lock Stats (View): view statistics in Raycast
Update Lock State (Background): auto-detect every 60 seconds
Lock Time Menu Bar (Menu Bar): show today's lock time in menu bar
Quick actions: Manual Update (Cmd+U), Diagnostics (Cmd+T), Copy Stats, Reset Today / Reset All Data
Privacy-first: all data stored locally in Raycast LocalStorage, no network requests, no accounts
Built with TypeScript + React on Raycast API v1.93.0
State machine architecture (LOCKED ↔ UNLOCKED) with automatic daily reset

Compatibility

macOS

Subscribe to our newsletter.

Get product updates and news in your inbox. No spam.

Lock Time

Quietly tracks how long your Mac stays locked and how long you stay focused between unlocks.

Mai Yang

28 Installs

Install Extension

Overview

Lock Time

Quietly tracks how long your Mac stays locked — and how long you stay focused between unlocks.

Features

Today Locked Time — Cumulative lock duration for today, press Enter to view session breakdown
Today Lock Sessions — Drill down to see each lock session's time range and duration
Last Lock Duration — How long your last lock session lasted, with time range (e.g. 12:57 → 13:48)
Last Unlock Interval — How long you worked continuously between unlocks
Menu Bar — Real-time lock time displayed in your menu bar with time range info
Zero Config — Works immediately after installation, no setup required
Local-First — All data stored locally, nothing leaves your Mac
Fast — First load in under 0.5s, cached loads under 0.1s

Commands

Command	Type	Description
Lock Stats	View	View today's lock time statistics
Update Lock State	Background	Automatically detects and updates lock state every 60 seconds
Lock Time Menu Bar	Menu Bar	Shows today's cumulative lock time in the menu bar

How It Works

Lock Time checks your Mac's lock state every 60 seconds using a multi-level detection strategy:

Swift + CGSessionCopyCurrentDictionary (primary) — Queries the CoreGraphics system API directly for the CGSSessionScreenIsLocked field. No extra permissions needed. Most reliable on macOS 13+.
AppleScript frontmost process detection (fallback) — Infers lock state by checking if the frontmost process is loginwindow or ScreenSaverEngine.
Gap Detection (safety net) — When the polling interval exceeds the expected threshold (>90s), infers that the Mac was locked during the gap.

If detection fails, the extension preserves the last known state rather than guessing.

Actions

Refresh (Cmd+R) — Refresh statistics
Copy Stats — Copy all stats to clipboard
Diagnostics (Cmd+T) — Run real-time detection diagnostics
Manual Update (Cmd+U) — Force a state update
Reset Today — Reset today's statistics
Reset All Data — Clear all stored data

Data Privacy

All data is stored exclusively in Raycast LocalStorage
No network requests are made — ever
No account or sign-in required
Uninstalling the extension removes all data completely

Versions4

Session History & Time Range - March 2, 2026

Added lock time range display for Last Lock Duration (e.g. 12:57 → 13:48)
Shows lock start/end time alongside the duration, no more mental math to recall when the lock happened
Added Today Lock Sessions drill-down detail view
Press Enter on Today Locked Time to see each session's time range and duration
Provides full visibility into work/rest rhythm throughout the day
Menu Bar now displays time range info for last lock session
Added LockSession data structure (lockAt / unlockAt / durationMs) and extended MetricsData with session tracking fields
State machine records complete session on LOCKED→UNLOCKED transition, with cross-midnight splitting
Added formatTime() / formatTimeRange() formatting utilities
Added SessionDetailView component with Action.Push drill-down interaction
Backward compatible: automatically fills default values for missing new fields in old data

Performance Optimization - March 2, 2026

Improved first-screen loading speed by 83% (from ~3s to ~0.5s)
Cache hit speed improved by 97% (repeated opens within 5s take <0.1s)
useLockData Hook: display cached data first, detect in background
detectLockStateWithInfo(): added 5-second detection result cache with skipCache param
processStateChange(): parallelized LocalStorage read/write, conditional writes reduce unnecessary I/O
Manual diagnosis (Cmd+T) forces cache skip for real-time status

Fixed Lock Detection on macOS 26 - March 2, 2026

Fixed lock detection completely broken on macOS 26
JXA ObjC bridge cannot properly bridge CFDictionary, causing CGSSessionScreenIsLocked field to be lost
Switched to native Swift CGSessionCopyCurrentDictionary() call for reliable bridging
Fixed AppleScript detection defaulting to "unlocked" on failure
Now preserves last known state instead of defaulting to unlocked
Fixed Lock Stats not triggering state machine on open
useLockData() now executes processStateChange() on first load
Upgraded detection to multi-level fallback: Swift CGSession → AppleScript → Gap Detection
Background no-view command logs now use fs.appendFileSync() to prevent async log loss

Initial Version - March 2, 2026

Core lock time tracking
Today Locked Time: cumulative lock duration for today
Last Lock Duration: duration of the most recent lock session
Last Unlock Interval: continuous work time between unlocks
Three usage modes
Lock Stats (View): view statistics in Raycast
Update Lock State (Background): auto-detect every 60 seconds
Lock Time Menu Bar (Menu Bar): show today's lock time in menu bar
Quick actions: Manual Update (Cmd+U), Diagnostics (Cmd+T), Copy Stats, Reset Today / Reset All Data
Privacy-first: all data stored locally in Raycast LocalStorage, no network requests, no accounts
Built with TypeScript + React on Raycast API v1.93.0
State machine architecture (LOCKED ↔ UNLOCKED) with automatic daily reset

Compatibility

macOS

Lock Time

Lock Time

Features

Commands

How It Works

Actions

Data Privacy

Commands3

Versions4

Session History & Time Range - March 2, 2026

Performance Optimization - March 2, 2026

Fixed Lock Detection on macOS 26 - March 2, 2026

Initial Version - March 2, 2026

Subscribe to our newsletter.

Lock Time

Lock Time

Features

Commands

How It Works

Actions

Data Privacy

Commands3

Versions4

Session History & Time Range - March 2, 2026

Performance Optimization - March 2, 2026

Fixed Lock Detection on macOS 26 - March 2, 2026

Initial Version - March 2, 2026