macarchy
Omarchy's desktop, on the MacBook you already own.
An Omarchy-style layer for macOS: one command restyles
the terminal, multiplexer, editor, status bar, window borders and wallpaper,
and windows tile over native Spaces. System Integrity Protection stays on.
macarchy is an independent project, not affiliated with or endorsed by
Omarchy or the Omacom Foundation. Ported themes are used under Omarchy's MIT
licence; see NOTICE.
It started as one person's config and is built around the tools I use, but
you do not have to take all of it. The installer asks which parts you want:
just the themes, just the window manager, or any mix (see
Components). Themes cover Ghostty, kitty, Alacritty, iTerm2,
VS Code (and Cursor, VSCodium, Windsurf), Zed, Zellij and Neovim; see
Scope. The reasoning is in Why macarchy exists.
| Area | What |
|---|
| Theming | theme-set <name> restyles your terminal (Ghostty, kitty, Alacritty, iTerm2), editor (VS Code and forks, Zed, Neovim), Zellij, SketchyBar, JankyBorders and the wallpaper together, skipping apps you don't have. docs/theme-system.md |
| Window management | yabai (tiling) + skhd (hotkeys) + SketchyBar (status bar) + JankyBorders (focus border), layered over native macOS Spaces, no SIP changes. The bar draws above the menu bar, auto-hidden or not; shift + alt - m swaps between the two. docs/window-management.md |
| Recovery | macarchy-doctor names the silent failures (secure keyboard entry killing skhd, a lost Accessibility grant after brew upgrade yabai, windows off every display, a stale border); shift + alt - r restarts yabai, borders, the bar and skhd; display changes and wake re-rescue windows on their own, and a notification names any app whose window will not come back (macarchy-rescue --relaunch reopens it). docs/window-management.md |
| Hotkey discovery | alt - / pops up a searchable which-key style list of every skhd binding; Enter runs it. Also lists Ghostty and Zellij keybinds when those configs exist |
| Theme picker | shift + alt - / pops up theme-pick, an fzf picker with truecolor swatches for all 22 themes, in a floating window of your terminal (MACARCHY_TERMINAL); Enter applies it |
| Raycast | a generated "Set Theme" script command |
| Workspace agent | ws: plain-English (or voice, alt - w) control of windows, Spaces, theme, wallpaper and terminal tabs via an on-device 14 MB model. docs/agent.md |
| Speech-to-text | Handy (offline, open-source; brew cask handy, installed by install.sh) transcribes for ws --voice. Its own hotkey, alt - space (hold to talk, tap to toggle), is configured inside Handy, not skhd. |
Themes live under home/.config/theme/themes/. 23 themes ship: all 22 of
Omarchy's, under the
same names and with the same backgrounds, brought over with
theme-port <name>, plus hollow, which is custom (Sleepy Hollow in
October: pumpkin, candle flame and a harvest-moon wallpaper). See
docs/omarchy-port.md. Light themes need
--allow-light and a manual check afterwards, because the SketchyBar and
border colour derivations assume a dark background. To make your own, run
theme-new <name>, edit its colors.sh, then theme-new --regen <name>.
5 of the 23 are light:
- Dark (18): catppuccin, ethereal, everforest, gruvbox, hackerman,
hollow, kanagawa, last-horizon, lumon, matte-black, miasma, nord, osaka-jade,
retro-82, ristretto, solitude, tokyo-night, vantablack
- Light (5): catppuccin-latte, flexoki-light, lupine, rose-pine, white
Scope
macarchy is opinionated on purpose. It is not a framework for every Mac setup,
and it does not try to be.
What it themes:
- Terminals: Ghostty, kitty, Alacritty and iTerm2 (all 16 ANSI colours,
cursor and selection). Popups open in whichever one
MACARCHY_TERMINAL
names, WezTerm included.
- Editors: VS Code, Cursor, VSCodium, Windsurf and VS Code Insiders (through
the marketplace theme the Omarchy theme maps to), Zed (a generated
"Macarchy" theme) and Neovim (a LazyVim plugin spec).
- Zellij, SketchyBar, JankyBorders and the wallpaper.
Each app is one hook script in home/.config/theme/hooks/. theme-set runs
them all, and a hook for an app you don't have exits without doing anything.
Your own hooks go in ~/.config/macarchy/hooks.d/.
What it does not do:
- Theme WezTerm's colours, Terminal.app, JetBrains IDEs or browsers. A hook
for any of them is one short script; see
docs/theme-system.md.
- Theme VS Code for the 7 themes that have no matching marketplace theme
(hollow, ethereal, lupine, miasma, ristretto, vantablack, white). A
switch to one of those leaves VS Code on its previous theme.
- Manage your terminal, editor or multiplexer configs. It adds one include
line to each and the configs stay yours; see
Hooking in your own configs.
- Replace macOS Spaces or touch System Integrity Protection. yabai runs
without its scripting addition, so a few yabai features are unavailable; see
docs/window-management.md.
- Derive bar and border colours for light themes. The five light themes ship
because each was checked by hand after porting.
The hotkeys, the bar layout and the five-Space default are my preferences.
Most of them are a config edit or a file away from being yours. Some are
hard-coded.
Components
Each part installs on its own. ./install.sh asks on the first run and
saves your answer as MACARCHY_COMPONENTS in ~/.config/macarchy/config.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
