Skip to content
CAI
Software that uses CAICheck a score

d12frosted/homebrew-emacs-plus

55.1

Adequate · 5 November 2026

5.3k

lines of production code

Ruby

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add support for undecorated frames with rounded corners on macOS

Users can now create macOS frames that are both undecorated and have rounded corners by setting the new \undecorated-round\ frame parameter. This change introduces the parameter to the frame configuration, adds the corresponding \undecorated\_round\ field to the frame structure, and implements the necessary logic in the NS (macOS) backend to apply the \NSFullSizeContentViewWindowMask\ style and hide standard window buttons (close, minimize, zoom) while maintaining transparency.

patches/emacs-32 · high confidence

Adds configurable frame transparency and background blur for macOS

This patch introduces configurable frame transparency and background blur support for macOS (Cocoa frames) in Emacs 31. Users can now set the \alpha-background\ frame parameter to control window opacity and \ns-background-blur\ to apply a dynamic blur effect to the frame background. Additionally, the \ns-alpha-elements\ parameter allows fine-grained control over which UI elements (such as the default face, fringes, or glyphs) are rendered with transparency. The patch modifies Emacs source files (\frame.c\, \nsfns.m\, \macfont.m\) to support these new frame parameters and includes documentation and example configurations for applying these settings at startup or via hooks.

community/patches/frame-transparency · high confidence

The \community/icons\ directory now provides a centralized gallery of community-maintained Emacs icons. Users can select an icon by name in their \\~/.config/emacs-plus/build.yml\ for both formula and cask installations. The gallery includes standard \.icns\ icons as well as three icons (\dragon-plus\, \liquid-glass\, \retro-emacs-logo\) featuring macOS Tahoe liquid glass support via \Assets.car\ and light/dark preview variants.

community/icons · high confidence

Introduce pre-built Emacs+ casks for stable, next, and master branches

Users can now install pre-built Emacs+ applications via Homebrew Cask for three release tracks: \emacs-plus-app\ (stable, currently Emacs 31.1), \emacs-plus-app@next\ (release branch, currently Emacs 31.1.50), and \emacs-plus-app@master\ (development, currently Emacs 32.0.50). These casks provide arm64-only binaries for macOS 15 (Sequoia) and later, requiring \gcc\ and \libgccjit\ for native compilation, and include post-install scripts to handle quarantine removal, custom icons, and symlink management. They conflict with other Emacs casks and the \emacs-plus\ formula to prevent installation conflicts, with caveats warning users to choose either the cask or the formula.

Casks · high confidence

New community icon and patch tooling with macOS Tahoe support

This change introduces a suite of scripts to manage community contributions and support macOS Tahoe icon standards. Users can now create and register custom icons or patches via \create-community-icon.rb\ and \create-community-patch.rb\, which validate inputs and update the \community/registry.json\. The \generate-tahoe-assets\ script enables building Tahoe-compliant \Assets.car\ files for light/dark mode previews, while \generate-icon-previews.rb\ automatically produces visual galleries. Post-install logic is now handled by \cask-postflight\ and \formula-postinstall\ wrappers that invoke Ruby logic, and \postinstall-cask.rb\/\postinstall-formula.rb\ allow simulating these steps on existing installations for testing.

scripts · high confidence

New opt-in patch for CJK font line-height rendering on macOS

A new community patch, \mac-font-use-typo-metrics\, is now available for Emacs 29, 30, and 31 on macOS. It fixes line-height calculation for CJK fonts by reading typographic metrics from the OS/2 table instead of the hhea table, resolving issues like partial screen rendering, clipped text, and misalignment in vterm or other pixel-sensitive modes. Because this patch may cause reduced line height for some Latin-only fonts (e.g., PragmataPro), it is provided as an opt-in feature; users can enable it by adding \mac-font-use-typo-metrics\ to their \\~/.config/emacs-plus/build.yml\ patches list and rebuilding Emacs.

community/patches/mac-font-use-typo-metrics · high confidence

Architecture

Repository structure and tooling overhaul

The repository has been restructured to improve developer experience and maintainability. A new Makefile replaces the previous build scripts, providing standardized targets for testing, validating build configurations, and building or installing formulas and casks locally. Documentation has been migrated from Markdown to Org mode (README.org, NEWS.org) for better integration with Emacs workflows. A new RuboCop configuration (.rubocop.yml) enforces consistent Ruby style across formulae and casks, while a new .dir-locals.el sets project-specific defaults for Emacs users. Additionally, a new iconset generation script (iconset) and updated .gitignore rules streamline asset management and clean up the repository.

(repo-wide) · high confidence

Behavioural changes

Emacs 26: Fixes for unexec, accessibility, and color fonts on macOS

This update applies three patches to Emacs 26 for macOS. It fixes a bug in the unexec mechanism (used for saving images) by correcting region alignment and merging logic in src/unexmacosx.c. It also corrects the accessibility role for Emacs windows from TextField to Window in src/nsterm.m, and allows color bitmap fonts to be used if their family is explicitly specified, rather than blocking them entirely, in src/macfont.m.

patches/emacs-26 · high confidence

Emacs 29: round undecorated frames and tree-sitter compatibility

This update adds support for Emacs 29 by introducing a new \undecorated-round\ frame parameter for macOS, which allows undecorated frames to have rounded corners while preserving their geometry when toggled. It also includes a tree-sitter compatibility fix that updates the code to use the \ts\_language\_abi\_version\ function instead of the deprecated \ts\_language\_version\, ensuring correct grammar library loading.

patches/emacs-29 · high confidence

Emacs formulae split into versioned packages (emacs-plus@26 through @32)

The single \emacs-plus\ formula has been removed and replaced with separate, version-specific formulae (emacs-plus@26, @27, @28, @29, @30, @31, and @32). This allows users to install and maintain specific Emacs versions side-by-side. Each versioned formula is tailored to its target release: for example, Emacs 30 and newer enable Ahead-Of-Time (AOT) native compilation by default and include WebP support, while older versions like 26 and 27 retain legacy options such as \--with-no-titlebar\ or specific dependency configurations. The unified \emacs-plus\ alias is no longer available.

Formula · high confidence

Improved TTY read performance on macOS

A new community patch, aggressive-read-buffering, is available for Emacs 29, 30, and 31. It modifies the \emacs\_intr\_read\ function in \src/sysdep.c\ to handle macOS's 1024-byte TTY/pty buffer limit by looping with a short delay to read remaining data, significantly improving performance when processing large quantities of output.

community/patches/aggressive-read-buffering · high confidence

New modular post-install infrastructure and build configuration system

The Library now introduces a structured, modular approach to post-installation and build configuration, replacing the previous monolithic methods. Formula and cask post-install logic is now centralized in FormulaPostinstall and CaskPostflight, executed via dedicated CLI entry points (FormulaPostinstallCLI and CaskPostflightCLI) to comply with Homebrew's \post\_install\_steps\ requirements. A new BuildConfig module handles the parsing and validation of \build.yml\, supporting version-mapped settings for icons, patches, and path injection. Icon management is unified through IconApplier, which applies custom icons from the community registry or external sources to both Emacs.app and Emacs Client.app. Additionally, CaskEnv manages environment injection for native compilation and CLI usage, while PlistExtras handles macOS privacy declarations and AutoFill opt-outs.

Library · high confidence

Update default emacs-plus alias to version 31 and add master alias for version 32

The default \emacs-plus\ alias now points to version 31 (via \[e-mail redacted]\), replacing previous defaults. Additionally, a new \emacs-plus@master\ alias has been introduced, pointing to version 32 (via \[e-mail redacted]\), allowing users to access the latest development build.

Aliases · high confidence

macOS Cocoa patches for Emacs 27

This update applies a suite of patches to Emacs 27 for macOS Cocoa, introducing several behavioral changes and new capabilities. It adds support for system appearance changes (light/dark mode) on macOS 10.14+ via a new hook and variable, fixes code signing issues on Apple Silicon (ARM) by updating the Makefile, and resolves a freeze issue with ligatures in the mode line by allowing pure-ASCII unibyte string composition. Additionally, it improves accessibility by correcting the window role, prevents unwanted frame refocusing on Cocoa, enforces an undecorated window style, and enables xwidgets (Webkit) support on macOS alongside new keybindings for webkit sessions.

patches/emacs-27 · high confidence

macOS UI and appearance improvements for Emacs 28

This update applies several patches to Emacs 28 on macOS to enhance the user interface and system integration. It introduces a 'no title bar' option that can optionally retain rounded window corners, removes the automatic frame refocusing behavior when a frame is deleted, and fixes the accessibility role to correctly identify Emacs windows. Additionally, it improves support for macOS Mojave (10.14) and later by updating the dark appearance handling and adding hooks to react to system-wide appearance changes (light/dark mode).

patches/emacs-28 · high confidence

Fixes

Emacs 30 macOS patches: Tahoe scrolling fix, undecorated round frames, and tree-sitter ABI update

This location adds a suite of patches for Emacs 30 on macOS. It fixes scrolling lag and input handling on macOS 26 (Tahoe) by disabling specific event processing features, and refreshes the x-colors list during NS window initialization to ensure the full palette is available at runtime. It introduces support for undecorated frames with round corners via a new \undecorated-round\ frame parameter. Additionally, it updates tree-sitter compatibility to use the \ts\_language\_abi\_version\ function, correcting version mismatch checks, and ensures the system appearance hook correctly uses the \ns\_appearance\_dark\_aqua\ type on macOS 10.14+. A symlink patch reuses the window role fix from Emacs 28.

patches/emacs-30 · high confidence

macOS-specific patches for Emacs 31

This update adds several patches to the Emacs 31 build target for macOS. It fixes a crash in the NS scroll code (bug\#81585) that occurred when toggling off the header-line with pixel-scroll-precision-mode enabled. It also ensures x-colors are refreshed during NS window system initialization to correct color lists captured in headless dump environments. Additionally, it introduces support for undecorated frames with round corners, allowing users to create frames without decorations and with rounded corners, and adds a hook to react to macOS system appearance changes (light/dark mode) so themes can be updated automatically.

patches/emacs-31 · high confidence

Test coverage

Added test suite for build and packaging logic

Added comprehensive test coverage for the build and packaging infrastructure, including validation of build configuration files, PATH injection logic in CaskEnv, AppleScript escaping for Emacs Client.app, postflight and postinstall scripts for both casks and formulas, and the consistency of AppleScript activation logic across the formula, cask, and CI workflow sources.

tests · 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 51 → 55 (+4.5)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 64 → 65 (+0.1)
  • Architecture 99 → 99 (+0.0)
  • Maturity 44 → 60 (+16.3)
  • Readiness 61 → 61 (+0.0)
  • Security 45 → 45 (+0.0)

Resolved (2)

  • EmacsBase.apply_custom_patches (cognitive 18) (Library/EmacsBase.rb)
  • Off-boarding risk: anonymized user #1

New (1)

  • Off-boarding risk: anonymized user #1

Changes since last survey

  • 38 commits — 34 feature/other, 4 fixes

By area

  • Casks/[e-mail redacted] — 16 commits
  • Casks/[e-mail redacted] — 15 commits
  • Casks/emacs-plus-app.rb — 3 commits
  • (root) — 2 commits
  • Library/EmacsBase.rb — 1 commit
  • tests/test_build_config.rb — 1 commit

Notable commits

  • fix: Fix renamed Emacs cask conflict references
  • fix: fix(emacs-plus-app): find the tap through HOMEBREW_REPOSITORY
  • fix: fix(patches): apply custom patches non-interactively
  • fix: fix(service): restart the daemon only when it crashes
  • change: chore(emacs-plus-app): update cask to build 382
  • change: chore(emacs-plus-app): update cask to build 385
  • change: chore(emacs-plus-app@master): update cask to build 380
  • change: chore(emacs-plus-app@master): update cask to build 381
  • change: chore(emacs-plus-app@master): update cask to build 383
  • change: chore(emacs-plus-app@master): update cask to build 384
  • change: chore(emacs-plus-app@master): update cask to build 386
  • change: chore(emacs-plus-app@master): update cask to build 387
  • change: chore(emacs-plus-app@master): update cask to build 388
  • change: chore(emacs-plus-app@master): update cask to build 389
  • change: chore(emacs-plus-app@master): update cask to build 390
  • change: chore(emacs-plus-app@master): update cask to build 391
  • change: chore(emacs-plus-app@master): update cask to build 392
  • change: chore(emacs-plus-app@master): update cask to build 393
  • change: chore(emacs-plus-app@master): update cask to build 394
  • change: chore(emacs-plus-app@master): update cask to build 395
  • …and 18 more

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

Survey your own repository

d12frosted/homebrew-emacs-plus 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 5 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 23dda17bfad0a3763fddaeebcbf269b777e21373 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — 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.2+preprod-5c4e66d9318b.