Hypruse

From its catalog listing

Hyprland computer use through the hypruse CLI: controls from the accessibility tree clicked by number, typing and keys sent to one window, and a background mode where the agent works in apps on its own workspaces (99 down to 90) while your cursor, focus and workspace stay put. Select it with `hermes config set computer_use.backend hypruse`.

Good to know before installing

the provider is pure Python with no third-party dependencies. Each action runs the separately installed `hypruse` command (0.13 or newer), or the one named in `computer_use.hypruse.command` or HERMES_HYPRUSE_CMD, as a subprocess with no shell, and that child gets only the desktop session variables and HYPRUSE_* settings, never Hermes' API keys; `hermes computer-use doctor` also runs `hypruse doctor`. hypruse clicks, types and presses keys in your live session, and a foreground pointer action moves your cursor. With the optional `computer_use.hypruse.delivery: auto`, an action on the window you are in runs on your screen. Screenshots of the targeted window, or of the focused monitor for `app='screen'`, go to your model like any computer-use backend's, and each capture file is deleted once read. It reads hypruse's state file `$XDG_RUNTIME_DIR/hypruse/cli-state.json` and never writes it. No network calls, telemetry, stored data or credentials.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install hypruse
  2. Said no? Turn it on later:
    hermes plugins enable hypruse
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Hermes Desktop add-ons · Automation & multi-agent
Maintained by
IlyasKhallouki (Community)
Needs
No API keys declared
Works on
linux
Needs Hermes
0.23.0 or newer
Version
0.1.0
In the catalog
2026-11-10
GitHub stars
57

Known issues (from its catalog listing)

  • Needs Hyprland and the hypruse command 0.13 or newer on PATH (PyPI, AUR or Nix), which this plugin does not install. Check it with hermes computer-use doctor.
  • set_value is not supported: hypruse has no verb that sets a value. Click the field and type, or click the control.
  • Modifier keys held during a click, drag or scroll, and triple clicks, are not supported.
  • The pointer never works in the background: coordinate clicks, drags and scrolls need delivery_mode='foreground' on the window you are in, and right, middle and double clicks by element work only in the foreground.
  • som captures (marks) are sent at full size; max_image_dimension applies to vision captures only.
  • computer_use has no launch action: run hypruse launch -- APP with the terminal tool to open an app on the agent's workspaces, then capture(app='APP').
  • Does not load under plugins.isolation: host, because Hermes loads computer-use providers only in its own process.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in hermes desktop add-ons

All hermes desktop add-ons plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins