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.

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

Twitch Desktop ToolsUse the Twitch panel and notification recovery scripts.

Resume RecoveryRefresh the Omarchy shell, Git panel, and Twitch notifications after suspend.

Git Shell PanelUse and recover the unified repository and GitHub notification panel.

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.