Knowledge Base
Practical setup notes for system customisations and one-off fixes.
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 Auth
Set up Omarchy FIDO2 auth for sudo, polkit, and Hyprlock with touch-first daily prompts.
Workspace Setup
Rebuild the desktop host’s work and non-work workspace layout.
Workspace Relayout
Apply and capture ratio-based Hyprland layouts for the active workspace.
Workspace Session Recovery
Capture and restore Hyprland window sessions after restarts, crashes, or layout experiments.
Work Browser Launchers
Launch work Chrome, Slack, and Discord into predictable Hyprland workspaces.
URL Routing and Webapps
Route matching URLs to Omarchy webapps while keeping the normal browser fallback.
Doorbell Popup
Open a Home Assistant camera popup from a doorbell or motion entity.
Twitch Desktop Tools
Use the Twitch panel and notification recovery scripts.
Resume Recovery
Refresh the Omarchy shell, Git panel, and Twitch notifications after suspend.
Git Shell Panel
Use and recover the unified repository and GitHub notification panel.
System Health Triage
Collect a short health report for freezes, slowdowns, thermal issues, and noisy logs.
Desktop Command Wrappers
Small helper scripts for terminal launches, notifications, loading overlays, and workspace placement.
GitHub Dotenv Secrets
Import simple
.env keys into GitHub Actions repository secrets with gh.