Skip to content
Dotfiles logoDotfiles

Omarchy & Hyprland

These dotfiles run on Omarchy. Some Omarchy components are tracked as managed git repos that dot keeps in sync, while Hyprland and Ghostty config are stowed dotfiles packages with per-host overrides.

Host OverridesManaged Omarchy repos and stowed host config.
ControlsThe dot omarchy desktop controls menu.

Managed Omarchy repos

Section titled “Managed Omarchy repos”
  • waybar and uwsm are single-branch Omarchy repos expected on main.
  • dot update syncs these by default; dot doctor verifies their worktree branches.
  • Waybar module commands are stowed from scripts/.local/bin/; the Waybar repo contains only their config and Waybar-specific test and benchmark harnesses.
  • package-updates-bar backs off automatic AUR checks after HTTP errors. An explicit refresh retries immediately, so a recovered AUR connection clears stale unavailable state.

Hyprland

Section titled “Hyprland”

Hyprland config is not a tracked Omarchy repo. It is a stowed dotfiles package (hypr/.config/hypr/, conf-only) laid down with --no-folding, with host-specific overrides selected by a runtime symlink. See Host Overrides.

Shared application floating rules generated by float-app live in the stowed ~/.config/hypr/float-app.conf. looknfeel.conf includes that file, so new rules remain part of the Hypr package rather than becoming unmanaged live config.

SUPER+W runs the stowed close-active-window script. It lets Ghostty handle its own close confirmation and uses Hyprland’s normal close action for other applications.

Ghostty

Section titled “Ghostty”

Ghostty config is also stowed from ghostty/.config/ghostty/. The stowed launcher loads config.$OMARCHY_HOST when a host override exists.

Terminal bells mark the Ghostty tab title without requesting focus, so notifications do not switch Hyprland workspaces.

dot update restores the Herdr Lazy lockfile, links the stowed local Herdr plugins, and starts the title watcher.

Agent Usage and GitHub PR status are tracked through the same Herdr Lazy list and lockfile. The Agent sidebar shows the workspace-aware title and current branch PR status, billing provider and shortest limit window, then context usage. ALT+X, then U opens the full limits pane; ALT+X, then SHIFT+U refreshes the meters. Browser-cookie import is disabled in the managed Herdr server environment, so OpenCode Go uses local estimates unless an explicit cookie is supplied outside this public repository. Agent Usage notifications are disabled by default and no credentials are stored in dotfiles.

The local Mise Task Runner opens with ALT+X, then SHIFT+M. It lists local tasks from the focused pane’s directory, previews the selected task, and runs it in a focused new tab so its output remains available. The memex session palette opens with ALT+X, then F.

Ghostty’s normal tab shortcuts are redirected to Herdr while its client window is active: CTRL+SHIFT+T creates a tab in the current workspace, CTRL+SHIFT+W closes the current tab, and CTRL+TAB / CTRL+SHIFT+TAB select the next or previous tab. Other applications receive the original key event unchanged. New tabs skip the naming prompt; the local Terminal Title plugin mirrors each pane’s existing Zsh or application title into its Herdr tab label. ALT+X, then S opens Sessionizer to focus an existing workspace or pick a Home Assistant repository under ~/repos/home-assistant; ALT+X, then Up opens its worktree picker. ALT+X, then W retains Herdr’s built-in workspace picker. ALT+X, then G toggles a lazygit side pane, while ALT+X, then SHIFT+G opens dot git-diff as an overlay. Both inherit the focused pane’s current directory. ALT+X, then Y opens Yazi beside the focused pane, and ALT+X, then SHIFT+Y opens it in a new tab. Herdr Lazy keeps the plugin list and exact lockfile in dotfiles for reproducible installs across systems; Renovate proposes lock commit updates and herdr-lazy restore applies the merged lockfile on each system. The tracked mirror plugin exposes configured remote Herdr workspaces in the local sidebar; machine-specific hosts remain in the private overlay, and ALT+X, then ALT+N creates a workspace on the default remote host. The lazygit plugin’s AI backend, pane widths, and commit prompt are also stowed, while generated and per-pane state remains local. ALT+X, then SHIFT+L opens the manager. Reviewr opens an agent-aware branch diff and review pane with ALT+X, then SHIFT+V; automatic opening is disabled so it does not change new-worktree layouts. Experimental pane history preserves recent terminal output across full Herdr server restarts, and Kitty graphics rendering enables compatible inline images in Ghostty. SUPER+Q and SUPER+SHIFT+Q attach another client to the shared default session. ALT+X, then Q detaches the client and leaves every pane process running. CTRL+D keeps its normal shell EOF behaviour, including in the final root shell; closing the final tab does not stop the persistent server. Outside Herdr the tab shortcuts keep their normal Ghostty behaviour. The global SUPER+SHIFT+T override sends Ghostty a dedicated shortcut that always creates a Ghostty tab, including while Herdr is focused.