# Herdr Macintosh A classic-Macintosh-inspired Herdr workspace in three editions: Platinum Color with a blue desktop, gray beveled windows and violet highlights; Classic Black & White with grayscale icons and a dithered desktop; and the fictional Midnight Platinum with charcoal/slate bevels, an indigo desktop and pastel accents. All three use the same pixel font throughout, live terminals, and real workspace/agent controls. Side regions are optional: the desktop icons start hidden, and persistent toolbar toggles let people choose maximum terminal space or the full nostalgic desktop. ![Herdr Macintosh](preview.png) ## What you see From top to bottom: - A 31 px edition-colored menu bar (light in Platinum/Classic, dark in Midnight): rainbow icon, Herdr, File, Edit, View, Special, Window; then live agent count, a minute clock and Finder. macOS traffic lights have an 85 px reserved region at the left. Other platforms do not reserve that region. - A desktop row inset 18 px vertically and 16 px horizontally, with 16 px gaps. Platinum uses a subtle blue texture around gray windows; Classic uses a black/white/gray dither texture; Midnight uses a subtle dark indigo grain around slate windows. - On the left, an optional 230 px Workspaces window (resizable 180–420 px). A striped title bar tops a list of spaces (white in Platinum/Classic, dark in Midnight), followed by New/Find controls, a striped Processes heading and the live agent list (up to 240 px high). Space rows show a colored folder or network icon, name, machine, and agent-status dot. The selected space/agent is violet with white text in Platinum and black with white text in Classic. A small footer identifies the edition. - The central workspace fills all remaining width. A 39 px beveled toolbar contains Spaces, the space name, tab buttons, +, Agent…, Files and Desktop. Below it are the actual tab's terminal/mod panes with square 2 px black frames, 12 px split gaps, and 27 px striped title bars. A 25 px status bar shows a shortened working folder, agent activity, edition and help icon. The tab strip/status/panes are separated by 10 px gaps. - Files is an optional 310 px panel beside the terminal (220–650 px). It is hidden initially and reuses Herdr's shipped file browser. - At the right is an optional 94 px desktop-icon strip. It starts hidden. When shown, it contains Macintosh HD, Workspaces, Control Panels, About This Mac, and Modern Herdr. Icons are original 32 px SVG drawings shown at 38 px; labels may wrap. Hiding the strip returns its width and neighboring gap to the terminal workspace. Platinum palette: chrome `#cccccc`, warm terminal background `#fffff5`, foreground `#202020`, violet accent/selection `#655195`, selected-tab tint `#c5b6e5`. Classic uses white, black and gray. Midnight palette: terminal `#141a22`, warm text `#dce4d6`, chrome `#30394b`, list/menu surfaces `#202837`, violet selection `#655282`, terminal/tab selection `#493d61`, lavender cursor `#c1a4ed`; bevel highlights `#69768d` and near-black shadows replace white edges. The actual palette's luminance determines bevel lightness so theme-picker overrides remain coherent. Midnight retains colored icons and uses pastel ANSI/status colors rather than inverting the light theme. Terminal and UI font: bundled Departure Mono 1.500. Main UI labels use 11 px, larger headings 16.5/22 px; terminals use 16.5 logical px. These sizes are designed for a Retina display at zoom 1, not pixel-perfect historical reproduction. ## How it behaves - Spaces and Desktop buttons remain in the toolbar even when their respective side regions are hidden. Files also toggles independently. Pressed states and View-menu checkmarks reflect the effective layout, including Herdr's persisted visibility. Each layout remembers its own clicks. - View → Focus Mode · Hide Sides hides Workspaces, Desktop Icons and Files. View → Full Macintosh Desktop brings both side regions back. It does not force Files open. - All three editions operate on the same spaces, tabs, panes and running terminals. The rainbow menu and View switch editions. The rainbow menu's Back to Herdr returns to `main`, even when every side region is hidden. The Modern Herdr desktop shortcut does the same. - Clicking a space selects it. Its context menu offers open, new terminal, rename and close using Herdr's commands. New creates a space; Find opens the shipped picker. Only the active space's branch is shown. - Agent states in Platinum: working green `#538b37` with a native opacity pulse; blocked orange-red `#c14c2c` and text “Needs you”; done blue `#426fba` and text “Finished”; idle gray `#90908a` and text “Ready”. Classic uses gray/black instead, retaining the text labels. Midnight uses working `#a3c890`, blocked `#edb27e`, done `#a5bff0`, idle `#8997b0`, retaining the same labels and pulse behavior. Blocked outranks done, working and idle in the menu-bar status indicator. The footer reports working/blocked counts. - Pinned agents appear first, otherwise preserving Herdr's order. Clicking an agent focuses it; right-click pins/unpins it. Agent-next/previous follows this displayed order. Herdr turns done into idle when the person looks at the agent; the mod does not simulate that transition. - Tabs select existing tabs, including settled tabs marked with a diamond. The + button opens a terminal. Agent… lists installed agents for the active space's machine and launches the selected agent as a new tab there. - A pane's close square ends that pane's terminal. Its zoom square toggles pane zoom; double-clicking the title also zooms. The collapse control settles the tab without stopping it. The tab strip still lists settled tabs. Clicking a title focuses its pane; right-click offers split-right/down, zoom, settle and close. - File offers new terminal/agent/space, splits and rename/close. Edit offers copy/paste and preferences. View offers visibility, presets, zoom and editions. Special offers the palette, agent navigation, window controls and layout selection. Window lists all spaces/tabs. Existing user keybindings are not changed; shown shortcuts are read from Herdr's bindings. - Menus highlight on hover, support Up/Down and Enter/Space, and Escape dismisses popups. Long lists scroll after a 620 px height cap. Terminal right-clicks use the clicked pane/terminal, not whichever one had focus previously. - Desktop shortcuts toggle Files/Workspaces, open Settings, open About, or return to main. About is a draggable native window with an edition label and rainbow/grayscale rule. Its square close control and Quite lovely button close only that window. - Pane movement and divider resizing remain Herdr's native behaviors. Pulsing status dots animate natively. The only repeating script timer is a 30-second clock update, redrawing only if its minute text changed. ## Built from One layout family with three JSON trees (`layouts/macintosh.json`, `layouts/macintosh-classic.json`, `layouts/macintosh-midnight.json`), three matching theme JSON files, screenshots for Settings, and one shared role-dispatched mod `macintosh`. Tree: root column → menubar block + desktop row → sidebar block, workspace column, desktop-icons block. Workspace → tabs block + work-body row + status block. Work-body → active-tab block and hidden files-panel column. The active-tab block's pane header uses the same mod with role `pane`. Other roles are `menubar`, `navigator`, `tabs`, `status`, `desktop`, `menu`, and `about`. - `main.js`: exported GPUI View dispatches from `props().role`, or the context-menu target. - `chrome.js`: menu bar, navigation, toolbar, headers, desktop, status and About. - `kit.js`: pixel-font text helpers, palette-aware bevels, edition metadata, title stripes, icons, status dots, effective-layout visibility, focus/full presets, menu/overlay helpers, action dispatch and agent lookup. - `menu.js`: explicitly sized popup, keyboard focus/navigation and target-aware terminal menu. - `check.js`: headless eager rendering of the non-live-pane roles. - `art/build.py`: standard-library builder for original SVG icons, PNG desktop textures and optional SVG concept previews. Existing screenshots are captured with `herdr-app shot`, not synthesized by this script. - `fonts/DepartureMono-Regular.otf`: unmodified Departure Mono 1.500 by Helena Zhang, redistributed with its SIL OFL 1.1 license and upstream README. No Apple fonts are distributed. Live `herdr` APIs: `spaces`, `agents`, `panes`, `focused`, `props`, `layout`, `shared` (current layout name), `keys`, `layouts`, `window`, `theme`, `setAgentOrder`, `knownAgents`, `nextCommand`, `run`, `openOverlay`, `closeOverlay`, `notify`. Layout switches, show/hide, tab/space/pane commands, terminal pin/copy/paste, agent navigation, window controls, help, Settings and the shipped picker all use existing Herdr commands. Mod commands: `macintosh.about`, `.appearance`, `.File`, `.Edit`, `.View`, `.Special`, `.Window`, `.focus`, `.desktop`. The mod makes no network requests, no direct `exec`/`hc` calls, and no arbitrary file reads/writes. Agent lookup asks Herdr which launchers are installed. Explicit user actions can launch terminal programs/agents. Shipped Files can read the active folder, as it normally does. All font/icon/texture assets are local. ## Watch out - This is an unofficial, historically inspired theme, not an Apple/Herdr product, a Macintosh emulator, or an exact pixel-for-pixel reproduction. Trademark rights are not granted by the code license. - Use this version's `herdr.d.ts` and `gpui-kit.d.ts`. Native GPUI builders, not HTML/CSS, describe the UI. No Node APIs, DOM, setTimeout or setInterval in mods. - Popup roots need explicit pixel width and height. `size_full()` alone passed a headless check but produced invisible popups. Keep both the overlay dimensions and the menu root dimensions coherent. The terminal context-menu default is 284 × 182 px. - Do not close the popup before an installed-agent lookup finishes: closing destroys the asynchronous task's owner. Keep it alive until lookup completes, then replace it; touch the task's own `cx` after awaiting to abort stale work. Never retain another callback's `cx`. - `layout()` can be null in a headless check. Visibility helpers must handle missing nodes. `window()` can be null there too. Real pane rendering must find its pane via `props().pane` and use explicit targets. - The theme requires all three layouts, their matching themes and `mods/macintosh` for its edition switches. Names and icon paths are intentionally linked. If renaming due to an installation collision, update those references, not only filenames. - Keep standard Herdr click state private: do not ship `layouts/.state`, keys/settings, shared/view state, logs, sockets or generated app type files. Never overwrite a person's existing files on install. - Classic changes ANSI colors, not explicit RGB colors or images a terminal program draws. Pi should use its built-in `system` theme if its own thinking/tool surfaces should follow the terminal; manually edited Pi settings need `/reload` after the response ends. Codex CLI 0.166.0 caches default terminal colors at startup; its `/theme` selector does not refresh that cache. Herdr's optional global `minimum_contrast: 3.0` protects text on stale light/dark surfaces. Do not modify personal agent settings or global preferences as part of a silent layout install; see README for the separately documented options. Fonts fall back for glyphs Departure Mono does not contain; Powerline/emoji/CJK are not guaranteed to look like the bundled face. - At fractional zoom/display scales, pixel-style outlines may soften. The upstream font recommends 11 px increments; 16.5 logical px is 33 device px at 2×. On non-Retina displays try 11 or 22 px terminals. The clock uses the host's local time. - Files, Settings, picker, rename/confirmation dialogs, toasts and palette are shipped Herdr UI, not custom Macintosh replacements. Colors/fonts inherit the layout; their shapes and behavior stay Herdr's. The code's UI body font is fixed to Departure Mono for consistency. - Macintosh HD is only a shortcut, not a disk. There are no fake Trash, disk-management or OS controls. Existing shortcuts are not rebound. UI is not dynamically rearranged for very narrow windows; hide sides and shorten tab names first. ## Done when 1. Both `herdr-app check ` and `herdr-app check ` pass. 2. Switch to all three layouts in a running Herdr, inspect a screenshot, and find no file/mod errors in `herdr-app status`. Midnight must have dark terminal defaults, dark UI surfaces and no glaring white bevel outlines; light and monochrome editions must retain their original look. 3. The same bundled font appears in menus, sidebar, headers, toolbar and actual terminal text, without breaking monospaced alignment. 4. Desktop starts hidden. Show/hide it with Desktop; the terminal gains/loses its width, and the toggle remains reachable. Do the same with Spaces. Repeat in all three editions. 5. View's checkmarks reflect those toggles; Focus Mode hides both sides and Files; Full Macintosh Desktop brings both sides back. 6. Open File/View/Window and About. Confirm visible, correctly sized content; navigate a popup with arrows and dismiss it with Escape. Close About with its own control. 7. Use a disposable test tab to split, focus, zoom and close only its panes; settle/unsettle that test tab; then close it. Original terminals must remain running. 8. Switch to main and back without replacing workspace contents. Confirm program output remains live. 9. Check Pi thinking/tool/result surfaces and the Codex input box in the dark edition. Check switching both ways, including Classic; never submit an existing draft for a theme test. A synthetic offline transcript can exercise Pi's real UI without model/tool execution. 10. Before publication, inspect every screenshot for personal paths, names and terminal output. Ship only the selective layout package, font license and documented assets—not the app configuration directory.