jurplel/InstantSpaceSwitcher

InstantSpaceSwitcher is a macOS utility that enhances desktop space navigation by providing instant switching via trackpad gestures, global hotkeys, and a command-line interface. It features a configurable settings interface for managing shortcuts and gesture speeds, along with diagnostic tools to detect macOS window management states. The system is distributed as a universal binary with automated build and packaging scripts.

Users can now use a 3-finger trackpad swipe to instantly switch between desktop spaces, bypassing the default animation. This feature intercepts the gesture event, calculates the target space index based on the swipe direction, and performs an immediate switch. The implementation includes a prediction system to track the current space index per display and a configurable gesture speed parameter that scales with the number of workspaces to ensure consistent timing.

Sources/ISS · high confidence

A new JavaScript utility (overlay\_check.js) and its accompanying test script (test\_overlay\_live.sh) have been added to the expose-mc-detect-diag directory. The utility queries macOS window layers via the Accessibility API to distinguish between App Exposé and Mission Control based on specific layer counts (18 and 20) associated with the Dock process. This provides a programmatic way to diagnose the current state of macOS window management overlays.

expose-mc-detect-diag · high confidence

The distribution process now includes a build script that compiles the application for both arm64 and x86\_64 architectures in parallel and combines them into a single universal binary. This script also bundles the CLI tool into the application package, injects the current git commit hash into the app metadata, and performs ad-hoc code signing. Additionally, a deployment script is provided to automatically generate a DMG installer from the built application bundle.

dist · high confidence

The \ISSCli\ command-line utility now supports switching to a specific desktop space by its numeric index (e.g., \ISSCli index 3\), in addition to the existing left/right directional commands. This allows users to jump directly to a target space rather than navigating sequentially. The tool also includes improved error handling for invalid index inputs and switch failures.

Sources/InstantSpaceSwitcher · high confidence

This change introduces the core application structure for InstantSpaceSwitcher, a macOS utility for navigating between virtual spaces. The code establishes the main entry point and application delegate, which initializes the underlying ISS event tap for space detection, manages accessibility permissions, and configures hotkey bindings. It also implements the menu bar status item, providing a system tray icon that displays the current space number and offers a menu to switch spaces left/right, jump to specific spaces, or open settings. The implementation includes logic to handle application re-launches by opening the preferences window and supports configuration options for swipe overrides, gesture speed, and menu bar icon visibility.

Sources/InstantSpaceSwitcher/Core · high confidence

The application now includes a new hotkey subsystem in the InstantSpaceSwitcher module, introducing a \GlobalEventTapRecorder\ for capturing global key and mouse events, a \HotKeyManager\ for registering and triggering system-level hotkeys, and a \HotkeyRecorder\ UI component that allows users to interactively record and assign custom key combinations. This change replaces previous ad-hoc handling with a structured approach to hotkey configuration and activation.

Sources/InstantSpaceSwitcher/Hotkeys · high confidence

The ISS header exposes a comprehensive set of functions for managing macOS Spaces, including retrieving current space information, checking move validity, and switching to specific space indices. It introduces gesture customization via a new swipe override mode for instant space switching and configurable gesture speed. Additionally, the API now includes detection capabilities for App Exposé and Mission Control states, along with a callback system for tracking successful space switches and a prediction reset mechanism.

Sources/ISS/include · high confidence

The application's preferences have been rebuilt using a new tabbed layout (General and Keyboard) and a reusable form-based UI component. Users can now configure the on-screen display (OSD) duration, enable an experimental Mission Control/Exposé detection mode, and toggle a 3-finger swipe override. A new 'Animation Speed' setting allows users to adjust the gesture velocity from Normal to Instant. The Keyboard tab provides a comprehensive table view for managing shortcuts for up to 10 spaces, the last used space, and left/right navigation, featuring a dedicated shortcut recorder control that handles key capture and re-registration.

Sources/InstantSpaceSwitcher/UI · high confidence

The application has been bumped to version 2.0 (build 2), with the display name and copyright metadata added to the Info.plist. Build artifacts are now explicitly ignored via .gitignore, and development tooling configurations (.clangd, .swiftlint.yml) have been added to support the C11 and Swift codebases.

(repo-wide) · high confidence

Added a new test suite (ExposeMcDetectTests) that validates the underlying C functions for detecting App Exposé and Mission Control states. The tests use hardcoded window list data captured from macOS Sequoia to verify correct detection behavior, including distinguishing between the two modes based on layer-20 window counts and handling edge cases such as empty lists, non-Dock windows, and small HUD overlays.

Tests · high confidence

The build configuration now links the IOKit framework, enabling access to lower-level I/O Kit APIs for system interaction. Additionally, a new test target named ISSTests has been added to the package manifest to support unit testing for the ISS module.

(dependencies) · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 55 → 48 (-6.3)
• Rubric changed (rubric-2026.09.11 → rubric-2026.09.18) — scores are not directly comparable.

• Code Health 97 → 97 (+0.0)
• Architecture 95 → 99 (+4.1)
• Maturity 44 → 44 (+0.4)
• Readiness 48 → 34 (-13.8)
• Security 61 → 61 (+0.0)

• Documentation: no architecture or design documentation (README.md)
• Hotspot: Sources/InstantSpaceSwitcher/Core/AppDelegate.swift (Sources/InstantSpaceSwitcher/Core/AppDelegate.swift)
• Hotspot: Sources/InstantSpaceSwitcher/Hotkeys/HotkeyConfiguration.swift (Sources/InstantSpaceSwitcher/Hotkeys/HotkeyConfiguration.swift)
• Hotspot: Sources/InstantSpaceSwitcher/UI/KeyboardShortcutsViewController.swift (Sources/InstantSpaceSwitcher/UI/KeyboardShortcutsViewController.swift)

• Coverage not measured — Swift suite

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

jurplel/InstantSpaceSwitcher was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.