Omahub
← All plugins
C

Hermes Desktop Overlay

by crueber

Quake-style pull-down HUD for Hermes Desktop: a hotkey drops a floating 75%-screen Hermes window over your current work in a dedicated special workspace.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
4d782ce
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
4d782ce
Reviewed
1 month ago

Manual review found no malicious, destructive, or hidden behavior. The plugin's QML entry point is a no-op, and the shell scripts only add or remove clearly marked window-rule and keybinding blocks in the user's Hyprland config as documented, then reload Hyprland. The deterministic scan's "none" result matches this assessment.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/crueber/omarchy-hermes-desktop-overlay --enable
Productivity #Hyprland #ai

omarchy-hermes-desktop-overlay

Quake-style pull-down HUD for Hermes Desktop on Omarchy. A hotkey drops a floating Hermes window over 3/4 of your screen, dimming what's behind it; press the hotkey again and it slides back up. If Hermes isn't running yet, the first press launches it.

It works at the Hyprland level: the app lives in its own special workspace (special:hermes) that overlays whatever you're working on, with Omarchy's built-in slide animation. No QML UI — the plugin's shell entry point is a deliberate no-op.

Requirements

  • Omarchy (Hyprland 0.55+ with Lua config)
  • Hermes Desktop installed at /usr/bin/hermes-desktop (omarchy install / pacman -S hermes-agent-desktop)

Install

omarchy plugin add https://github.com/crueber/omarchy-hermes-desktop-overlay
~/.config/omarchy/plugins/crueber.hermes-overlay/install.sh

The default hotkey is SUPER + SHIFT + H. To pick a different key (or a different launch command):

./install.sh --key "SUPER + GRAVE" --launch "/usr/bin/hermes-desktop"

install.sh writes clearly marked, idempotent blocks into ~/.config/hypr/hyprland.lua (window rule) and ~/.config/hypr/bindings.lua (keybinding), then reloads Hyprland and validates the config.

Usage

Key Action
SUPER + SHIFT + H Toggle the Hermes HUD open/closed

Uninstall

~/.config/omarchy/plugins/crueber.hermes-overlay/uninstall.sh
omarchy plugin remove crueber.hermes-overlay

Customization

Edit the managed block in ~/.config/hypr/hyprland.lua, or reinstall with different options:

  • Window size: change the 0.75 fractions in the rule's size.
  • Transparency: change opacity = "0.96" (or remove it).
  • Backdrop dimming: remove dim_around = true.
  • Different app: HERMES_OVERLAY_CLASS, HERMES_OVERLAY_WORKSPACE, and HERMES_OVERLAY_LAUNCH env vars override the toggle script's defaults, so the same pattern works for any single-window app.

How it works

  1. A window rule matches the Hermes window class (hermes) and forces it floating, centered, sized to 75% of the monitor, opened silently into the special:hermes workspace.
  2. The keybinding runs scripts/hermes-overlay-toggle, which launches Hermes if needed and dispatches hl.dsp.workspace.toggle_special('hermes').
  3. Special workspaces render over the active workspace and inherit Omarchy's vertical slide animation, producing the drop-down HUD effect.

License

MIT