mirror of
https://github.com/LGUG2Z/komorebi.git
synced 2026-11-15 05:12:28 +01:00
macos-handcheck.md grew by appending sections from several authors (A-H, the review checks H1-H12, deep-dedup rows, bar clicks, settings rows), so the owner had to merge them by hand. The new runbook orders every item by what could make the daemon unusable first: prerequisites, startup and the command path (shared transport, shared SocketMessage, lock order), hiding and restoring (shared Container/Workspace/Monitor, HideSpot), the window registry and leaks, the pointer preamble, settings reload, the rest of the walk-through, the bar, then the known issues that are expected to misbehave. Each item has steps, the expected result, how to stop or roll back, the revision that introduced it, a mark where a second display, trackpad or cables are needed, and a time estimate per block (about 5 hours in all). It opens with the list of commands that must not be run on a Mac that has a live komorebi (stop, start, quickstart, autostart, pkill, state-changing komorebic commands, SIGSTOP on pids not just started), with the reasons read from the code: a second daemon exits when a process named komorebi exists, and a daemon deletes the socket in the user data directory on exit. The original document is kept as the source. Commands were checked against the checked-in macOS docs/cli page list; nothing was run on a Mac. Not built.