Skip to content
CAI
Software that uses CAICheck a score

omacom/try-omarchy

49.9

Weak · 15 November 2026

19k

lines of production code

Swift

with Python

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Automated build versioning, caching, and release workflows

The build system now includes dedicated Python scripts to manage the release lifecycle. \app\_version.py\ stamps the application's Info.plist with the exact Git release tag (e.g., v1.2.3) and build count, ensuring the app version matches the repository tag. \build-cache.py\ implements an input-hash-based cache to skip expensive builds when source files or environment details have not changed. \release.py\ provides a unified command to select a version, build the guest and runtime components, tag the commit, and package the final DMG, while enforcing that the worktree is clean and the built artifacts match the intended version. Also in this area: 1 commit (0 fixes) modifying scripts; Kit notarization verification and bundle path correction; Kit versioning and integrity verification.

scripts · medium confidence · unverified

Automated code signing and notarization for macOS kits

A new Python script (scripts/kit\_signature.py) has been added to handle the signing and notarization of macOS kits. It signs all Mach-O binaries within the kit using Developer ID certificates with hardened runtime and secure timestamps, verifies signatures against expected entitlements and team identifiers, and submits the final archive for Apple notarization. This ensures that distributed kits meet macOS security requirements and are accepted by Gatekeeper.

python · high confidence

Introduce Omarchy VM Helper with app update checks, VM settings, and integration status

The macOS app now includes a dedicated helper process (OmarchyVMHelper) that manages several user-facing capabilities. Users can now opt-in to automatic checks for new app releases on GitHub, with a manual check option and a dedicated updates window. The VM start menu allows users to configure guest memory allocation and immersive (fullscreen) mode preferences. Additionally, a status item in the menu bar displays the health of guest integrations (such as sudo Touch ID and battery mirroring) and provides a way to review or repair them. Also in this area: Improved bridged networking availability and settings window behavior; Support for embedded run mode and metered network handling; Improved launch progress visibility and Korean Caps Lock support; Redesigned launcher with sidebar navigation and System Settings-style UI; VM migration inspection and per-VM history tracking; and 3 more.

macos/Sources/OmarchyVMHelper · high confidence

Introduce the try-omarchy guest package for Mac host integration

This change introduces the \try-omarchy\ guest package, which installs the host bridges (audio, clipboard, camera, battery, time zone, Touch ID, and settings) into the VM. It adds a DKMS kernel module to mirror the Mac's battery status, configures the system to disable VM suspend/hibernate, and provides a custom Italian keyboard layout for Apple hardware. The package also includes a wrapper for Ghostty to ensure it runs on the software renderer, adds a menu extension to customize Omarchy's settings rows, and implements a time zone picker that defaults to "Same as macOS". Also in this area: 6 commits (0 fixes) modifying guest; 1 commit (0 fixes) modifying guest.

guest/package/try-omarchy, guest/package/try-omarchy/files/etc, guest/package/try-omarchy/files/usr/bin · medium confidence · unverified

Introduce the try-omarchy guest package for Mac host integration

This change introduces the \try-omarchy\ guest package, which installs the host bridges (audio, clipboard, camera, battery, time zone, Touch ID, and settings) into the VM. It adds a DKMS kernel module to mirror the Mac's battery status, configures the system to disable VM suspend/hibernate, and provides a custom Italian keyboard layout for Apple hardware. The package also includes a wrapper for Ghostty to ensure it runs on the software renderer, adds a menu extension to customize Omarchy's settings rows, and implements a time zone picker that defaults to "Same as macOS". Also in this area: 6 commits (0 fixes) modifying guest; 2 commits adding/updating tests in guest; 1 commit (0 fixes) modifying guest.

guest/package, guest/package/tests · medium confidence · unverified

Native macOS app with privileged bridged networking and self-contained runtime

The macOS directory now contains the native application layer, including a Swift/AppKit lifecycle, a pinned QEMU ARM64 runtime with HVF and VirGL, and a privileged bridged networking helper. The app bundles a self-contained QEMU runtime (commit c3d48b7) with checksum-pinned dependencies and custom patches for Cocoa, immersive mode, and audio continuity. It introduces a new start menu allowing users to configure CPU, memory, and disk capacity, and lets them choose the VM's data location. A new bridged networking system uses a signed XPC daemon (socket\_vmnet v1.2.2) to manage host interfaces, with automatic Wi-Fi compatibility and adapter reconnection. The app also handles persistent disk management, including safe growth and migration of older disk formats, and integrates with macOS privacy permissions for camera, microphone, and folders. Also in this area: Improved guest pointer tracking and window size stability; Support for embedding the VM in third-party apps via a dedicated kit; Improved launch progress visibility and Korean Caps Lock support; Redesigned launcher with sidebar navigation and System Settings-style UI; VM migration inspection and per-VM history tracking; and 3 more.

macos, macos/patches · high confidence

New factory image build system for aarch64 Omarchy guests

Added a new build pipeline in guest/factory to produce the factory disk image used by the app. This includes a Containerfile, build scripts, and documentation that construct a stock generic-aarch64 Omarchy install from upstream repositories, applying the same full-disk layout and provisioning steps as the official ISO installer. The resulting image is sealed for reproducibility and cloned for each new VM instance. Also in this area: 6 commits (0 fixes) modifying guest.

guest/factory · medium confidence · unverified

New guest build infrastructure and documentation

The guest directory now includes a complete build system for the Omarchy VM image, featuring a new build script, a Docker-based factory builder, and a mount-free pacstrap utility. This setup allows the app to generate the factory disk and integration package in a controlled ARM64 environment, with repository keys and documentation added to support the new build process.

guest · high confidence

Try Omarchy guest integration and native Mac features

This update installs the Try Omarchy guest package, which configures the Linux VM to integrate seamlessly with macOS. It enables native Wayland rendering for applications, bridges macOS audio, camera, and clipboard to the guest, and syncs the guest clock and timezone with the Mac host. The package also adds support for macOS Touch ID for sudo and 1Password, handles the Mac's camera notch in the desktop bar, and allows the root filesystem to grow with VM disk settings.

guest/package/try-omarchy/files/usr · high confidence

Removals

Removal of Cloudflare Worker entry point

The Cloudflare Worker entry point file (worker/index.ts) has been removed from the codebase. This file previously handled image optimization requests via the /\_vinext/image path and routed other requests through the application handler, applying specific Cross-Origin isolation headers. Its removal indicates that the worker-based serving logic for these functions is no longer present in this location.

worker · high confidence

Removal of database scaffolding and example code

The project has removed the default database configuration files and the D1 example implementation. Specifically, the main \db/index.ts\ and \db/schema.ts\ files, which previously provided a basic Drizzle ORM setup and an empty schema placeholder, have been deleted. Additionally, the \examples/d1/db/schema.ts\ file, which contained a sample 'notes' table definition for Cloudflare D1, has been removed. Users no longer have access to these out-of-the-box database structures or the example code for integrating Drizzle with D1.

db, examples · high confidence

Removed browser-based demo launcher component

The \DemoLauncher\ component, which previously allowed users to launch a disposable, client-side Omarchy virtual machine directly in the browser with capability checks for WebAssembly and Threads, has been removed from the application.

app/components · high confidence

Removed notes API route from D1 example

The notes API route (app/api/notes/route.ts) has been removed from the D1 example application. This eliminates the ability to create or retrieve notes via the API within this specific demo, as the file containing the GET and POST handlers for the notes table is no longer present.

examples/d1 · high confidence

Removed the browser-based Omarchy demo and ChatGPT authentication

The app no longer includes the disposable browser-based virtual machine demo or the ChatGPT authentication flow. The root page, global styles, layout, and the \chatgpt-auth.ts\ module have been deleted, removing the ability to try Omarchy directly in the browser via this interface.

app · high confidence

Architecture

Project migrated from Next.js/Vite web starter to native macOS app build system

The repository has been restructured to support a native Apple Silicon macOS application that runs an ARM64 virtual machine, replacing the previous Next.js/Vite web starter setup. This change removes web-specific configuration files (including \next.config.ts\, \vite.config.ts\, \eslint.config.mjs\, \tsconfig.json\, and \drizzle.config.ts\) and introduces a new \Makefile\ to manage the build pipeline for the guest image, QEMU runtime, and the native Swift app. The project now relies on a \macos/\ directory for the launcher and runtime patches, and \guest/\ for the virtual machine image, with documentation updated in \README.md\, \CONTRIBUTING.md\, and \AGENTS.md\ to reflect the new native workflow and build requirements.

(repo-wide) · high confidence

Behavioural changes

4 commits (0 fixes) modifying guest/package/try-omarchy/files/usr/share

A change to existing behaviour in guest/package/try-omarchy/files/usr/share — 4 commits, 11 files: “Name the guest's settings entry VM Settings, whichever app runs the VM”; “Name the settings row in Omarchy's menu Try Omarchy Settings in every app”; “Let a two-finger swipe go back and forward in browsers (\#401)”; and 1 more (refs \#401, \#358).

guest/package/try-omarchy/files/usr/share · medium confidence · unverified

Improved VM lifecycle management and protocol resilience

The kit client now handles VM termination more reliably by sending a SIGTERM followed by a second SIGTERM and eventual SIGKILL, ensuring the helper process stops even if the guest OS is unresponsive. The run-mode protocol has been hardened to gracefully ignore unknown event codes from newer kit versions, preventing crashes when encountering new event types. Additionally, the client now supports a 'notice' event to report when bridged networking is unavailable, falling back to shared networking, and the storage location logic has been refined to respect the user's chosen VM folder from the full app while maintaining security constraints. Also in this area: Introduce TryOmarchyKitClient library for VM lifecycle management.

macos/Sources/TryOmarchyKitClient · high confidence

Networking daemon now locates payloads relative to its own binary

The networking daemon no longer assumes a fixed app bundle structure; instead, it discovers its runtime payloads (server, supervisor, and client) in a resources directory located beside the daemon binary. This allows the daemon to function correctly regardless of its installation path, provided the resources remain adjacent. A new \check\ command verifies that the helper, payloads, and client identity match the build-time pins, and the build script now records the relative resource path for the daemon to use.

macos/network-helper · high confidence

Test coverage

2 commits adding/updating tests in guest/tests; Added CI test suite for guest desktop, package installation, and first-boot setup; Added comprehensive test suite for macOS VM components; Added regression tests for VirGL format probing and shader input policies; Added tests for app version stamping, build caching, and icon packaging; Added tests for the VM kit validation, manifest logic, and run-mode end-to-end behavior; Expanded test coverage for OmarchyVMHelper; Updated kit validation tests for bundle packaging and signing requirements.

Dependencies

Removed Node.js site-creator-vinext-starter project and added macOS Swift package

This change removes the Node.js-based 'site-creator-vinext-starter' project, including its package.json and package-lock.json files, which previously managed dependencies like React 19.2.6, Vite 8.0.13, and Wrangler 4.92.0. Simultaneously, it introduces a new Swift Package Manager manifest (Package.swift) for the 'OmarchyVMHelper' executable, targeting macOS 15.0 and Swift 5 language mode, establishing the build structure for the native macOS VM helper component.

(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 47 → 50 (+2.7)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 82 → 77 (-5.0)
  • Architecture 88 → 90 (+2.2)
  • Maturity 66 → 72 (+6.3)
  • Readiness 37 → 41 (+4.8)
  • Security 79 → 79 (+0.0)
  • Event-Driven 38 → 38 (+0.0)
  • Performance 74 → 85 (+11.4)

Resolved (22)

  • Duplicated block (10 lines × 2) (macos/Sources/OmarchyVMHelper/NativeAudioBridge.swift)
  • Duplicated block (20 lines × 2) (macos/Sources/OmarchyVMHelper/QEMUGPULauncher.swift)
  • Duplicated block (21 lines × 2) (macos/Sources/OmarchyVMHelper/NativeAudioBridge.swift)
  • Duplicated block (33 lines × 2) (macos/Sources/OmarchyVMHelper/StartMenuPresentation.swift)
  • FileTooLong: scripts/build-cache.py (scripts/build-cache.py)
  • Hotspot: macos/Sources/OmarchyVMHelper/VMStorageEditor.swift (macos/Sources/OmarchyVMHelper/VMStorageEditor.swift)
  • No ADRs found
  • Off-boarding risk: anonymized user #1
  • build-cache.regular_files (cognitive 18) (scripts/build-cache.py)
  • build-cache.validate_guest (cognitive 22) (scripts/build-cache.py)
  • build-cache.validate_guest (cyclomatic 20) (scripts/build-cache.py)
  • build-cache.validate_runtime (cognitive 23) (scripts/build-cache.py)
  • build-cache.validate_runtime (cyclomatic 17) (scripts/build-cache.py)
  • kit_signature.sign (cognitive 16) (scripts/kit_signature.py)
  • kit_signature.verify (cognitive 64) (scripts/kit_signature.py)
  • kit_signature.verify (cyclomatic 35) (scripts/kit_signature.py)
  • release.choose_version (cognitive 35) (scripts/release.py)
  • release.choose_version (cyclomatic 16) (scripts/release.py)
  • release.verify_release_artifacts (cognitive 17) (scripts/release.py)
  • release.verify_release_artifacts (cyclomatic 16) (scripts/release.py)
  • …and 2 more

New (31)

  • Duplicated block (10–14 lines × 3) (macos/Sources/OmarchyVMHelper/NativeAudioBridge.swift)
  • Duplicated block (14–18 lines × 2) (macos/Sources/OmarchyVMHelper/NativeAudioBridge.swift)
  • Duplicated block (21 lines × 2) (macos/Sources/OmarchyVMHelper/NativeAudioBridge.swift)
  • Edited copies of one member (3 members, 11+ corresponding lines) (macos/Sources/OmarchyVMHelper/SharedFolder.swift)
  • Edited copies of one member (3 members, 13+ corresponding lines) (macos/Sources/OmarchyVMHelper/StartMenuWindow.swift)
  • Edited copies of one member (4 members, 12+ corresponding lines) (macos/Sources/OmarchyVMHelper/NativeAudioBridge.swift)
  • Edited copies of one member (5 members, 5+ corresponding lines) (macos/Sources/OmarchyVMHelper/FullscreenPreferences.swift)
  • Edited copy of a member (10 corresponding lines) (macos/Sources/OmarchyVMHelper/NativeClipboardBridge.swift)
  • Edited copy of a member (13 corresponding lines) (macos/Sources/OmarchyVMHelper/StartMenuWindow.swift)
  • Edited copy of a member (16 corresponding lines) (macos/Sources/OmarchyVMHelper/NativeBridgeSocket.swift)
  • Edited copy of a member (17 corresponding lines) (macos/Sources/OmarchyVMHelper/QEMUGPULauncher.swift)
  • Edited copy of a member (17 corresponding lines) (macos/Sources/OmarchyVMHelper/QMPConnection.swift)
  • Edited copy of a member (20 corresponding lines) (macos/Sources/OmarchyVMHelper/VMStorageEditor.swift)
  • Edited copy of a member (21 corresponding lines) (macos/Sources/OmarchyVMHelper/QEMUGPULauncher.swift)
  • Edited copy of a member (26 corresponding lines) (macos/Sources/OmarchyVMHelper/VMStorageEditor.swift)
  • Edited copy of a member (27 corresponding lines) (macos/Sources/OmarchyVMHelper/VMApplicationController.swift)
  • Edited copy of a member (3 corresponding lines) (macos/Sources/OmarchyVMHelper/FactoryImageDownload.swift)
  • Edited copy of a member (3 corresponding lines) (macos/Sources/OmarchyVMHelper/HostDisplayCutouts.swift)
  • Edited copy of a member (35 corresponding lines) (macos/Sources/OmarchyVMHelper/LauncherView.swift)
  • Edited copy of a member (4 corresponding lines) (macos/Sources/OmarchyVMHelper/LauncherSettingsFile.swift)
  • …and 11 more

Changes since last survey

  • 13 commits — 13 feature/other, 0 fixes

By area

  • guest/package — 5 commits
  • guest/tests — 3 commits
  • macos/Tests — 3 commits
  • docs/integration-updates.md — 1 commit
  • macos/Sources — 1 commit

Notable commits

  • change: Boot the newly installed kernel after omarchy update, not the factory image's (#440)
  • change: Check the setup form's time zone default against Omarchy's new filter prompt (#444)
  • change: Count both stop signals in the run-mode test on a busy Mac (#453)
  • change: Document how to remove the old VM after importing (#431)
  • change: Keep Shift and Ctrl held when the mouse moves with an external keyboard (#421)
  • change: Keep the desktop drawing after Omarchy updates to Hyprland 0.57 (#442)
  • change: Note a missed menu in the container desktop check, keep requiring it in e2e (#452)
  • change: Open Omarchy's default PDF viewer in the desktop check (#451)
  • change: Put Omarchy on every Mac display in immersive mode (#407)
  • change: Restore the Plymouth boot splash (#430)
  • change: Start Try Omarchy after its app is renamed (#441)
  • change: Stop the audio bridge from keeping PipeWire busy while idle (#424)
  • change: Summon Omarchy's menu again in the desktop check when the first summon is lost (#450)

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

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

Survey your own repository

omacom/try-omarchy 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 46396918f744cb188dbbfb2a433883fd15afa595 — 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.