Skip to content

Manual: say what Omarchy 4.5 ships on a Mac - #124

Open
only21mil wants to merge 1 commit into
omacom:mainfrom
only21mil:manual-status-4-5
Open

only21mil wants to merge 1 commit into
omacom:mainfrom
only21mil:manual-status-4-5

Conversation

@only21mil

@only21mil only21mil commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

Problem

Omarchy 4.5 is out, but the Status page still reads as if the release were ahead and lists "M3 and M4 Macs, Touch ID" as not in the first release. stable carries omarchy-mac 0.2.3-2, with the Touch ID services and BCM4388 resume recovery, and the stable installer catalog admits M3 Macs and the MacBook Neo as "Untested". Hardware support, Install on a Mac and the omarchy-mac README lag the same way (details).

Change

Docs only, so no omarchy-mac version bump.

  • 14-status.md: what the first release ships, what is to come and what is left out, without the target note and order of work.
  • 12-hardware.md: BCM4388 for resume recovery; M3 Macs and the Neo admitted untested; the M3 heading goes from "edge testers" to "untested".
  • 02-install.md: link and check installer 2.3.16.
  • omarchy-mac/README.md: what fingerprint-readers relies on, not when to ship it.
  • mac-manual/README.md: drop the spent instruction to remove those target notes at release.

Verification

Setup. Ubuntu 26.04 (x86_64), markdown==3.7; built with mac-manual/build.py, captured in headless Chromium, 1280 px wide, the manual's one theme, Tokyo Night (dark). An AI agent, not a person, ran every check and capture.

Steps. Build each commit → capture each changed region.

Before, 28abebe (main) After, c3537fd
Status page: target note, order of work, and M3 Macs and Touch ID out of the first release
Status page: target note, order of work, and M3 Macs and Touch ID out of the first release
Status page: what the first release ships, what is to come, what is left out
Status page: what the first release ships, what is to come, what is left out
Supported Macs: M1 and M2 Macs only, M3 and M4 Macs not supported
Supported Macs: M1 and M2 Macs only, M3 and M4 Macs not supported
Supported Macs: M3 Macs and the MacBook Neo also admitted, marked untested
Supported Macs: M3 Macs and the MacBook Neo also admitted, marked untested
Wi-Fi row: BCM4378 and BCM4387 recover after resume
Wi-Fi row: BCM4378 and BCM4387 recover after resume
Wi-Fi row: BCM4378, BCM4387 and BCM4388 recover after resume
Wi-Fi row: BCM4378, BCM4387 and BCM4388 recover after resume
M3 section: edge testers, not part of the first release
M3 section: edge testers, not part of the first release
M3 section: untested
M3 section: untested
Install page linking installer 2.3.15
Install page linking installer 2.3.15
Install page linking installer 2.3.16
Install page linking installer 2.3.16

CI on 6b26ee4, the merge of c3537fd into 28abebe: five green checks, the manual's build included.

Links. Commits 28abebe and c3537fd; omacom/omarchy#14431; #120.

Not shown

  • Touch ID, Wi-Fi resume or an install on a real Mac; these claims rest on the sources below.
  • A boot without aurora-touchid showing enrolment, verification and suspend working, as the README's old condition asked; none is on record, and the file has shipped, so it gates nothing.
  • The stable catalog's signature: only its payload was read.
  • test/integration/all. Nothing the runtime reads changes.

Prior PRs

None make this change. #12 and #91, both by Scott Jones, added Touch ID and the installer link. Open #103, #64, #69 and #101 edit some of the same lines; whichever lands second needs a rebase (details).

Sources and detail

Each statement was checked against main, the published packages or the installer releases.

What 4.5 ships.

  • stable carries omarchy-mac 0.2.3-2. Its recipe in omacom/omarchy-pkgs pins ea0097a, which has fingerprint-readers, the Touch ID services and BCM4388 resume recovery (lib/wifi-supported).
  • The signed stable installer catalog (issued 2026-11-05) admits M3 Macs and the MacBook Neo, each with an "Untested" preview note. It lists no M4 Mac. Its latestVersion is still 2.3.15: it was issued the day before 2.3.16.
  • The front page already says 4.5 is out. The Status page keeps the pre-release order of work.
  • Install on a Mac links installer 2.3.15, while Homebrew installs 2.3.16.
  • The optional omarchy-mac-ml package on stable comes from omacom/omarchy-pkgs. Not checked: whether it works. Omarchy 4.5 neither installs nor offers it, so the MLX line stays.

The other pages. Hardware support names only BCM4378 and BCM4387 for Wi-Fi resume recovery, and says "M3 and M4 Macs are not supported", though the installer admits M3 Macs. Install on a Mac links installer 2.3.15. Homebrew installs 2.3.16, which fixes installs that fail at "Writing boot files". The omarchy-mac README still says to ship fingerprint-readers "only once" Omarchy has the fingerprint operations and m1n1 forwards /chosen/apfs-preboot-uuid. The file has shipped, and both of those are published.

Status page wording. At 28abebe the page says: "Until that release, read every page as the target, not as something you can install today." The packages are built for official Omarchy, which took in omacom/omarchy#14431. The first release ships M1 and M2 Macs, with M3 Macs and the Neo admitted untested; experimental Touch ID on M2 MacBooks, the M3 MacBook Air and the Neo, not on M1-family Macs. Still to come: the move for existing Macs.

Sources checked:

  • Touch ID boards: lib/touchid-eligibility (t8112, t6020, t6021, t8122 with J613 or J615, t8140; M1-family unsupported:m1-family).
  • Omarchy 4.5.0: omarchy-lifecycle-dispatch has enable-fingerprint and disable-fingerprint, and the fingerprint setup and removal call them. The tag contains Find fingerprint readers a platform names omarchy#14675.
  • m1n1: m1n1-aurora 1.6.1.aurora22-1 on stable pins omacom/m1n1 bc79acc, whose kboot.c sets /chosen/apfs-preboot-uuid.
  • Installer: the v2.3.16 release, its .dmg.sha256 and the Homebrew cask all give 2.3.16 and the same digest.

Scope. Nothing boot-critical or runtime-read changes. The Status page's sentence on what the packages are built against now says Omarchy took in omacom/omarchy#14431, which merged on 2026-10-10 and is in v4.5.0. Where desktop work goes is #120's change.

More checks. python3 mac-manual/build.py: "built 14 pages into mac-manual/dist", exit 0, on 28abebe (main) and c3537fd. .github/scripts/check-scope, .github/scripts/check-architecture-gates and omarchy-mac/test/all: exit 0 on c3537fd. The Verification builds used markdown==3.7. 28abebe is main's tip and this branch's base, so c3537fd is also the merged tree. diff -rq of the 28abebe and c3537fd dist/ trees: only status/, install/ and hardware/ change. python3 mac-manual/diagrams/gen.py, then git status --porcelain -- mac-manual/diagrams on c3537fd and a diff against the exported commit on 28abebe and c3537fd: no diff. The builder checks every internal link.

Images. Page regions of each build, captured by an AI agent in headless Chromium from the built files. A re-take on 2026-11-14, also by an AI agent, from fresh builds of 28abebe and c3537fd matches each image above byte for byte.

Overlapping PRs. Open #103 edits the same Status line (adding M5 Macs) and the Supported Macs line. #64 and #69 edit the README's Touch ID paragraph but keep the old ship sentence. #101 adds a sentence to the Wi-Fi row.

Generated with Claude Opus 5.5 in T3 Code Nightly

The Status page still described the release as the target, with a
pre-release order of work, and listed M3 Macs and Touch ID as not in it.
Omarchy 4.5 is out: stable carries omarchy-mac 0.2.3 with Touch ID and
BCM4388 resume recovery, and the stable installer catalog admits M3 Macs
and the MacBook Neo, marked untested.

- Status: say the packages are built for official Omarchy, which took in
  #14431, and what the first release ships, what is still to come (the
  move for existing Macs) and what is left out; drop the target note.
- Hardware: name BCM4388 for resume recovery, and say the stable catalog
  admits M3 Macs and the Neo as untested instead of not at all.
- Install: link installer 2.3.16, which Homebrew installs and which
  fixes installs failing at "Writing boot files".
- omarchy-mac README: Omarchy has the fingerprint operations from 4.5 on and the
  file has shipped, so say what it relies on instead of when to ship it.
- mac-manual README: drop the note to remove target notes at release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant