diff --git a/.chezmoiexternals/omarchy.toml b/.chezmoiexternals/omarchy.toml
new file mode 100644
index 0000000..788988b
--- /dev/null
+++ b/.chezmoiexternals/omarchy.toml
@@ -0,0 +1,6 @@
+[".config/omarchy"]
+    type = "git-repo"
+    url = "https://github.com/prdlk/omarchy.git"
+    refreshPeriod = "168h"
+    [".config/omarchy".pull]
+        args = ["--ff-only"]
diff --git a/AGENTS.md b/AGENTS.md
index eeed326..2ee2728 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -39,6 +39,7 @@ Fresh clone: `git submodule update --init`.
 | `~/.config/tmux-palette` | prdlk/tmux-palette | `.chezmoiexternals/tmux-palette.toml` |
 | `~/.config/television` | prdlk/television | `.chezmoiexternals/television.toml` |
 | `~/.config/yazi` | prdlk/yazi | `.chezmoiexternals/yazi.toml` |
+| `~/.config/omarchy` | prdlk/omarchy | `.chezmoiexternals/omarchy.toml` (git themes/plugins live in its `extras.txt`, not this repo) |
 | `~/.omp` | prdlk/omp | `.chezmoiexternals/omp.toml` |
 | `~/.config/nvim` | prdlk/nvim | `.chezmoiexternal.toml` (no refresh; local checkout wins) |
 | `~/.config/tmux/plugins/tpm` | tmux-plugins/tpm | `.chezmoiexternal.toml` |
diff --git a/docs/chezmoi/externals-and-ignore.mdx b/docs/chezmoi/externals-and-ignore.mdx
index c50151f..e9001bb 100644
--- a/docs/chezmoi/externals-and-ignore.mdx
+++ b/docs/chezmoi/externals-and-ignore.mdx
@@ -60,6 +60,7 @@ Per-app config repos, one file each in `.chezmoiexternals/<app>.toml`. Each is a
 | `yazi.toml` | `~/.config/yazi` | [prdlk/yazi](https://github.com/prdlk/yazi) |
 | `kitty.toml` | `~/.config/kitty` | [prdlk/kitty](https://github.com/prdlk/kitty) |
 | `ghostty.toml` | `~/.config/ghostty` | [prdlk/ghostty](https://github.com/prdlk/ghostty) |
+| `omarchy.toml` | `~/.config/omarchy` | [prdlk/omarchy](https://github.com/prdlk/omarchy) — `shell.json`, hooks, menu extensions, themed templates; git-installed themes/plugins are gitignored there and restored by its `install-extras` script, `calendars.json` is never committed |
 
 Edit these in place under `~/.config/<app>`, then commit and push from that checkout.
 
diff --git a/docs/desktop/index.mdx b/docs/desktop/index.mdx
index 9b92f24..771a2c8 100644
--- a/docs/desktop/index.mdx
+++ b/docs/desktop/index.mdx
@@ -16,7 +16,7 @@ Two Wayland compositors are configured side by side. niri is the original setup,
 | Page | Covers |
 | --- | --- |
 | [niri](/desktop/niri) | `~/.config/niri` (base config, Noctalia colors, the `config.d/` fragments, per-display profiles), niri helper scripts, the `niri-launch*` launchers, `cp-appid`, the `nirinit` user service |
-| [Hyprland](/desktop/hyprland) | `~/.config/hypr` Lua config on Omarchy: bindings, input, look and feel, monitors, hyprsunset, the portal; every `omarchy-*` script in `~/.local/bin` |
+| [Hyprland](/desktop/hyprland) | `~/.config/hypr` Lua config on Omarchy: bindings, input, look and feel, monitors, hyprsunset, the portal; every `omarchy-*` script in `~/.local/bin`. `~/.config/omarchy` (shell, hooks, menus, themes) is the [prdlk/omarchy](https://github.com/prdlk/omarchy) external, see [externals](/chezmoi/externals-and-ignore#app-externals) |
 | [Waybar](/desktop/waybar) | `~/.config/waybar`: module layout, stylesheet, the `window_pill.py` title module |
 | [Fonts and default apps](/desktop/fonts-and-apps) | `~/.config/fontconfig/fonts.conf`, `~/.config/mimeapps.list`, the Victor Mono Nerd Font packages |
 | [vicinae](/desktop/vicinae) | `~/.config/vicinae/settings.json`: launcher keybindings, font, extension shortcuts and aliases |