Knowledge Base

This section collects practical runbooks that sit below the main dotfiles reference. They are for system state that is useful to repeat, but too specific for the core command docs.

FIDO2 Security Key AuthSet up Omarchy FIDO2 auth for sudo, polkit, and Hyprlock with touch-first daily prompts.

Workspace SetupRebuild the desktop host's work and non-work workspace layout.

Workspace RelayoutApply and capture ratio-based Hyprland layouts for the active workspace.

Workspace Session RecoveryCapture and restore Hyprland window sessions after restarts, crashes, or layout experiments.

Work Browser LaunchersLaunch work Chrome, Slack, and Discord into predictable Hyprland workspaces.

URL Routing and WebappsRoute matching URLs to Omarchy webapps while keeping the normal browser fallback.

Hyprsunset DimmingUse gamma-only dimming on the laptop without changing colour temperature.

Doorbell PopupOpen a Home Assistant camera popup from a doorbell or motion entity.

Twitch Desktop ToolsUse the Twitch menu, channel picker, and notification recovery scripts.

Resume RecoveryRefresh Waybar, git caches, Twitch notifications, and update prompts after suspend.

System Health TriageCollect a short health report for freezes, slowdowns, thermal issues, and noisy logs.

Desktop Command WrappersSmall helper scripts for terminal launches, notifications, loading overlays, and workspace placement.

GitHub Dotenv SecretsImport simple .env keys into GitHub Actions repository secrets with gh.