didriksg/Crisp
61.3
Adequate · 15 November 2026
23.6k
lines of production code
Swift
primary language
5
measurements over time
What this system is
Features
Added Simplified and Traditional Chinese localizations
The app now includes user interface translations for Simplified Chinese (zh-Hans) and Traditional Chinese (zh-Hant), covering key UI strings such as display states (collapsed, expanded, disconnected) and naming conventions.
Crisp/Resources · high confidence
Added social share card generation scripts
New HTML templates and a README guide have been added to the \scripts/og-card\ directory to generate 1200x630px social share images (og:image) for English and Chinese locales, along with a separate download badge asset. These files enable the documentation site to display updated, identity-first marketing visuals on social platforms.
scripts/og-card · high confidence
Crisp 1.6.0: macOS 14 support, Sparkle auto-updates, crispctl CLI, and MIT license
Crisp now runs on macOS 14 (Sonoma) and includes an in-app auto-updater via Sparkle, replacing the previous manual GitHub release flow. A new command-line tool, crispctl, is bundled with the app to manage displays, brightness, and HDR from the terminal. The project has also re-licensed from MIT with the Commons Clause to plain MIT, and the build system now uses a Makefile for local development and CI checks.
(repo-wide) · high confidence
Introduce crispctl CLI and local control server for external automation
Crisp now ships a command-line tool (crispctl) and a local Unix socket server that allow external scripts and Shortcuts actions to control displays, brightness, HDR, and presets. The server enforces same-user access, serializes display connect/disconnect requests to prevent race conditions, and exposes display metadata, brightness boost state, HDR state, and presets. A helper installs the crispctl binary into /usr/local/bin via a symlink, requiring admin privileges only when necessary.
Crisp/Services · high confidence
Introduce crispctl command-line tool for display control
A new \crispctl\ command-line utility is now available to control Crisp display settings from the terminal or scripts. It communicates with the Crisp app over a local Unix socket to manage brightness, Extra Brightness, HDR, image adjustments, and presets, and includes commands to install agent skills for AI assistants. Also in this area: 1 commit (0 fixes) modifying Sources, scripts; Presets now capture color profile settings; crispctl now defaults to human-readable text output with --json for scripts; Presets can now control display power state; Monitor input switching and HDR capture in presets.
Sources · medium confidence · unverified
New diagnostic and build scripts for display calibration, localization, and DDC probing
The scripts directory now includes a suite of new tools: App Intents metadata generation helpers (appintents.sh), a runnable Swift validator for the BrightnessBoostMath logic (check-boost-math.swift), and Python scripts to enforce localization key coverage and translation completeness (check-localization-keys.py, check-translations.py). Additionally, several Swift diagnostic probes have been added to investigate display hardware behavior, including DDC channel validation and stress testing (ddc-probe.swift, ddc-stress-probe.swift, ddc-write-probe.swift), EDR headroom and overlay calibration (edr-inspect.swift, edr-spike.swift, edr-spike2.swift, edr-spike3.swift), HDR capability detection (hdr-probe.swift), and virtual display HiDPI mirroring verification (mirror-hidpi-probe.swift). A shell script (fetch-sparkle.sh) also automates the fetching and patching of the Sparkle updater framework.
scripts · high confidence
New display controls and shortcut management in the menu panel
The Crisp menu panel now includes several new per-display controls and a dedicated keyboard shortcuts section. Users can enable Extra Brightness (EDR upscaling) and explicit HDR toggles for compatible external monitors, and manage physical display disconnect/reconnect actions on Apple Silicon. A new Shortcuts section allows recording global keyboard shortcuts for HiDPI toggling and brightness adjustments. Additionally, the display arrangement view now supports drag-to-reposition with live name callouts, and the system auto-brightness toggle is available for built-in displays.
Crisp/Views · high confidence
Shortcuts integration and split-canvas panel architecture
Users can now control Crisp via the Shortcuts app, with actions to apply presets, set or get display brightness, toggle HDR, and manage Extra Brightness. The menu panel has been rebuilt using a split-canvas architecture that drives resize animations via CADisplayLink for smoother, display-synced motion, while also improving click handling and scroll behavior.
Crisp/App · high confidence
Behavioural changes
Enforce local CI checks before push
A new pre-push git hook has been added to run 'make check' locally before every push, mirroring the checks enforced by CI. This ensures that mechanical warnings and other quality gates are caught early, with the ability to bypass for a single push using 'git push --no-verify'.
.githooks · high confidence
Unified brightness control, precise key steps, and VRR detection
The display models now support a combined brightness slider that maps internal and external displays to a single absolute luminance target, ensuring perceptual consistency across different panel types. Brightness adjustments via keyboard keys now snap to fixed stops (16 steps, or quarter-steps with Option+Shift) to match the macOS OSD, and gamma/image adjustments are persisted using stable display UUIDs instead of volatile IDs to prevent settings from drifting after reconnections. Additionally, the system detects variable refresh rate (VRR) modes on external displays and labels them appropriately, while also capping the active display count to the number of physical ports to prevent phantom displays from appearing after undocking.
Crisp/Models · high confidence
macOS 27 menu bar item styling and interaction support
Added support for macOS 27's changed menu bar behavior by introducing a clear overlay window to intercept clicks before the system highlights the item, and a custom highlight renderer that draws the lit pill behind the icon since the native highlight method no longer works on this version. These changes ensure the Crisp menu bar item visually matches the macOS 27 HUD and responds correctly to user interaction.
Crisp/Utilities · high confidence
Test coverage
Expanded test coverage for display control, brightness logic, and DDC services
Added comprehensive headless tests for the Crisp application's core display management features. This includes validation for the \crispctl\ CLI parser, covering brightness, HDR, display connection toggling, preset application, and image adjustment commands. New tests verify the brightness key-step logic, including quarter-step fine adjustments and extra-brightness grids, as well as combined brightness math for matching external displays to built-in panels via absolute luminance. The DDC service matcher is tested for identity resolution strategies (exact serial, vendor/product fallback, and traversal order), while DDC operation queues are verified for serial execution per display and non-blocking behavior across different displays. Additional tests cover display mode geometry edge cases (720p floor, square modes, HiDPI fallbacks), notch detection, and pointer edge-crossing behavior for unaligned display arrangements.
CrispTests · 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 53 → 61 (+8.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 76 → 71 (-4.7)
- Architecture 92 → 99 (+7.8)
- Maturity 65 → 65 (+0.1)
- Readiness 49 → 49 (+0.0)
- Security 75 → 75 (+0.0)
- Performance 78 → 100 (+21.7)
Resolved (31)
- ArrangementView.swift.snappedRect (cognitive 17) (Crisp/Views/ArrangementView.swift)
- Duplicated block (8 lines × 2) (Crisp/Views/ExtraBrightnessView.swift)
- Duplicated block (8–9 lines × 2) (Crisp/Services/CrispControlServer.swift)
- FunctionTooLong: mirror-hidpi-probe.swift.top-level code (scripts/mirror-hidpi-probe.swift)
- Hotspot: Crisp/Models/DDCServiceMatcher.swift (Crisp/Models/DDCServiceMatcher.swift)
- Hotspot: Crisp/Services/OSDBannerService.swift (Crisp/Services/OSDBannerService.swift)
- Hotspot: Crisp/Views/MenuBarView.swift (Crisp/Views/MenuBarView.swift)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (Crisp/Services/DDCService.swift)
- Members sharing a duplicated core (6 members, 50+ identical tokens) (Crisp/Models/CrispControlModel.swift)
- Projects may be oversized for their cohesion
- Repeated repair: Crisp/Models/DisplayMode.swift (Crisp/Models/DisplayMode.swift)
- Repeated repair: Crisp/Services/BrightnessBoostService.swift (Crisp/Services/BrightnessBoostService.swift)
- Repeated repair: Crisp/Services/EDROverlayManager.swift (Crisp/Services/EDROverlayManager.swift)
- Repeated repair: Crisp/Utilities/BrightnessBoostMath.swift (Crisp/Utilities/BrightnessBoostMath.swift)
- Repeated repair: scripts/check-boost-math.swift (scripts/check-boost-math.swift)
- ResolutionService.restoreModeAfterWakeIfNeeded (cognitive 16) (Crisp/Services/ResolutionService.swift)
- check-localization-keys.main (cognitive 16) (scripts/check-localization-keys.py)
- check-translations.main (cognitive 21) (scripts/check-translations.py)
- ddc-probe.swift.top-level code (cognitive 34) (scripts/ddc-probe.swift)
- ddc-probe.swift.top-level code (cyclomatic 21) (scripts/ddc-probe.swift)
- …and 11 more
New (34)
- ArrangementSnap.snapped (cognitive 24) (Crisp/Models/ArrangementSnap.swift)
- ArrangementSnap.snapped (cyclomatic 20) (Crisp/Models/ArrangementSnap.swift)
- ArrangementView.thumbnails (cognitive 16) (Crisp/Views/ArrangementView.swift)
- Boundary-crossing change coupling: CrispControlServer.swift ↔ main.swift (Crisp/Services/CrispControlServer.swift)
- Duplicated block (14 lines × 2) (Crisp/Views/DisplayModeListView.swift)
- Duplicated block (8 lines × 2) (Crisp/Views/ExtraBrightnessView.swift)
- Duplicated block (8–9 lines × 2) (Crisp/Services/CrispControlServer.swift)
- Edited copies of one member (3 members, 4+ corresponding lines) (Crisp/App/AppDelegate.swift)
- Edited copies of one member (3 members, 7+ corresponding lines) (Crisp/Services/BrightnessService.swift)
- Edited copy of a member (11 corresponding lines) (Crisp/Services/PhysicalDisplayToggleService.swift)
- Edited copy of a member (11 corresponding lines) (Crisp/Services/VolumeService.swift)
- Edited copy of a member (11 corresponding lines) (Crisp/Views/MenuBarView.swift)
- Edited copy of a member (13 corresponding lines) (Crisp/Models/CombinedBrightnessMath.swift)
- Edited copy of a member (13 corresponding lines) (Crisp/Services/CrispControlServer.swift)
- Edited copy of a member (15 corresponding lines) (Crisp/Services/MirrorService.swift)
- Edited copy of a member (16 corresponding lines) (Crisp/Models/CombinedBrightnessMath.swift)
- Edited copy of a member (17 corresponding lines) (Crisp/Views/VirtualDisplayView.swift)
- Edited copy of a member (21 corresponding lines) (Crisp/Views/PanelBlocks.swift)
- Edited copy of a member (22 corresponding lines) (Crisp/Views/SystemAutoBrightnessView.swift)
- Edited copy of a member (3 corresponding lines) (Crisp/Services/DDCService.swift)
- …and 14 more
Changes since last survey
- 16 commits — 16 feature/other, 0 fixes
By area
- Crisp/Services — 6 commits
- (root) — 4 commits
- Crisp/Views — 4 commits
- Crisp/Models — 1 commit
- Sources/crispctl — 1 commit
Notable commits
- change: Add 120 Hz and 144 Hz options for virtual displays (#256)
- change: Add Marek Goldmann to the sponsors list (#275)
- change: Add a Rotation row to each display card (#270)
- change: Add volume and mute keyboard shortcuts (#257)
- change: Group the display card rows under Picture, Color, Brightness and Connection (#262)
- change: Keep the blackout rescue off while the screens go to sleep (#246) (#254)
- change: Let a move back undo an edge crossing jump (#273)
- change: Let every external monitor turn DDC volume off (#267)
- change: List HiDPI at native size on external displays (#248) (#252)
- change: Match the volume slider to the brightness slider (#271)
- change: Quit Crisp before the dev swap and build crispctl with it (#265)
- change: Resolve the repo root to its real path in dev.sh and release.sh (#263)
- change: Restore hidden HiDPI modes after a disconnect and at wake (#255)
- change: Send each DDC message twice, as other Mac DDC tools do (#269)
- change: Snap to center alignment in Arrange Displays (#268)
- change: crispctl: add virtual list, on and off (#233)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
didriksg/Crisp 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 2425d65344f53305c1811f90785624c65039e203 — 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.