jurplel/InstantSpaceSwitcher
52.0
Adequate · 15 November 2026
2.5k
lines of production code
Swift
with C
5
measurements over time
What this system is
Features
Add trackpad swipe override for instant space switching
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
Added diagnostic script to detect App Exposé and Mission Control states
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
Automated universal binary build and DMG packaging
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
CLI tool adds direct space switching by index
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
Initial release of InstantSpaceSwitcher core application
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
New global hotkey recording and management system
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
Behavioural changes
1 commit (0 fixes) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 1 commit, 6 files: “icon (\#resolves \#27)” (refs \#27).
Resources · low confidence · unverified
Add index-based switching and improve shutdown reliability
The CLI now accepts an 'index \<n\>' argument to switch to a specific space by its numeric position, in addition to the existing left/right directional commands. The tool also validates the index input, ensuring it is a positive integer, and provides a clearer error message if the switch request fails due to space bounds or permissions. Finally, the application now drains the event loop briefly before exiting to ensure a clean shutdown.
Sources/ISSCli · high confidence
Expanded space management API and gesture controls
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
Redesigned settings interface with granular gesture and shortcut controls
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
Version 2.0 release with updated metadata and build configuration
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
Test coverage
Added unit tests for overlay detection, hotkey combinations, and swipe progress
Added three new test suites to verify core input and UI behaviors: ExposeMcDetectTests validates the detection logic for App Exposé and Mission Control by checking window list layers and counts; HotkeyCombinationTests ensures correct handling of Option key variants (including AltGr/Right Option) and verifies default hotkeys for spaces 1–16; SwipeProgressTests confirms that swipe gesture phases (Began, Changed, Ended) use minimal signed progress values to minimize visual transition while maintaining direction consistency.
Tests · high confidence
Dependencies
Added IOKit framework dependency and test target
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 cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 52 → 52 (-0.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 98 → 95 (-3.0)
- Architecture 99 → 99 (-0.1)
- Maturity 54 → 54 (+0.0)
- Readiness 34 → 34 (+0.0)
- Security 61 → 61 (+0.0)
- Performance 100 → 100 (+0.0)
Resolved (1)
- No ADRs found
New (4)
- Edited copy of a member (10 corresponding lines) (Sources/InstantSpaceSwitcher/UI/FormView.swift)
- Edited copy of a member (12 corresponding lines) (Sources/InstantSpaceSwitcher/Core/AppDelegate.swift)
- Edited copy of a member (42 corresponding lines) (Sources/InstantSpaceSwitcher/Core/AppDelegate.swift)
- No ADRs found (Package.swift)
Changes since last survey
- 1 commits — 1 feature/other, 0 fixes
By area
- (root) — 1 commit
Notable commits
- change: icon (#resolves #27)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
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.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 2b883a995d1c81fbc6d75704372a6a0b546bb1ff — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.