hypruse icon

hypruse

ilyaskhallouki/hypruse · v0.15.1 · Tools & Integrations

by IlyasKhalloukiScan grade: GoodAwesome AI Plugins

MCP server: computer use on Hyprland, with workspaces, windows, mouse, keyboard and screenshots on the Wayland desktop, plus a background mode that works in other windows while your cursor and focus stay put

Protect this install with HOL Guard

Guard checks the skills and MCP servers a plugin adds on your machine and asks you before a risky action runs. The scores above are free, and no plan changes them.

Is hypruse a fit?

From the plugin's manifest and HOL's scan. Anything the plugin does not declare is shown as not declared.

Works with

  • Claude Code
  • MCP
  • Cursor
  • 1 skill
  • 1 MCP server

Before you install

Sign-in
Not declared
Declared access
Not declared
License
MIT

Check before relying on it

  • Some security checks did not finish: Cisco skill scan. See the evidence
  • The publisher has not verified ownership on HOL.

What is hypruse?

hypruse is a published tools & integrations plugin for AI coding agents that works with Claude Code, MCP and Cursor, developed by IlyasKhallouki and distributed through the HOL AI plugin registry. MCP server: computer use on Hyprland, with workspaces, windows, mouse, keyboard and screenshots on the Wayland desktop, plus a background mode that works in other windows while your cursor and focus stay put.

Canonical slug
ilyaskhallouki/hypruse
Version
v0.15.1 · updated Nov 16, 2026

Registry snapshot

Owner verification
Not verified
Marketplace source
.claude-plugin/marketplace.json
Scanner
HOL plugin scanner
Security result
Needs review
Digest verified
Yes
1 bundled skillRead, copy or download each SKILL.mdOpen skills

Trust and security

Trust & reputation

78

HOL Trust Score

Per-metric points (0–100 each) combined via a weighted average into the overall score.

Installability
100/100
Maintenance
100/100
MCP server setup
100/100
Plugin Security
88/100
Provenance
70/100
Publisher Quality
75/100

Provenance

Plugin root
.
Source repo
https://github.com/IlyasKhallouki/hypruse
Source commit
1ca642dbe266…
Publisher verified
No
Owner verified
Not owner verified
Agent Plugins 1.0
Not detected

Continuous scanner CI not detected

This plugin remains listed. Its overall trust score is reduced by 10% because security checks are not maintained in the source repository's CI.

Optional: maintain the scanner in the source repository's CI to receive the full trust score. Listing does not require that change.

README badge not detected

Plugin owners can add the HOL badge to the repository README from Guard Plugins. Distribution, not security evidence. It adds a 2% engagement adjustment to the overall trust score and never changes the security result.

Needs review
Security result
88
Security score
0
High findings
Provider
codex-plugin-scanner
Grade
B · Good
Version
3.24.2
codex:hol-plugin-scanner-hhrKa3 / cisco-skill-scanner: failedcodex:hol-plugin-scanner-hhrKa3 / cisco-mcp-scanner: skipped

[claude:.] Claude Plugin

18/18

5 checks

[claude:.] Security

16/16

6 checks

[claude:.] Operational Security

3/6

5 checks

[claude:.] Code Quality

10/10

2 checks

[codex:.] Manifest Validation

25/31

9 checks

[codex:.] Security

16/16

9 checks

[codex:.] Operational Security

3/6

5 checks

[codex:.] Best Practices

9/12

5 checks

[codex:.] Marketplace

N/A

3 checks · not applicable

[codex:.] Skill Security

5/5

4 checks

[codex:.] Code Quality

10/10

2 checks

Published advisories

None matched in GitHub security advisories, checked . This covers published advisories only, not problems nobody has reported.

GitHub security advisories are those the source repository has published.

Findings

lowoperational-securityDEPENDABOT_MISSINGReported 2 times

Automation or dependency surfaces exist, but .github/dependabot.yml is missing.

Add Dependabot updates for GitHub Actions and dependency manifests.

infomanifest-validationPLUGIN_JSON_INTERFACE_SHORTDESCRIPTION

The interface object is missing a valid "shortDescription" value.

Add a valid "shortDescription" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_LONGDESCRIPTION

The interface object is missing a valid "longDescription" value.

Add a valid "longDescription" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_CATEGORY

The interface object is missing a valid "category" value.

Add a valid "category" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_CAPABILITIES

The interface object is missing a valid "capabilities" value.

Add a valid "capabilities" field to the interface metadata.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_WEBSITEURL

The interface field "websiteURL" must use HTTPS or point to a safe in-repo asset.

Update "websiteURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_PRIVACYPOLICYURL

The interface field "privacyPolicyURL" must use HTTPS or point to a safe in-repo asset.

Update "privacyPolicyURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_TERMSOFSERVICEURL

The interface field "termsOfServiceURL" must use HTTPS or point to a safe in-repo asset.

Update "termsOfServiceURL" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_COMPOSERICON

The interface field "composerIcon" must use HTTPS or point to a safe in-repo asset.

Update "composerIcon" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_LOGO

The interface field "logo" must use HTTPS or point to a safe in-repo asset.

Update "logo" to use HTTPS or an existing relative asset path.

infomanifest-validationPLUGIN_JSON_INTERFACE_ASSET_SCREENSHOTS

The interface field "screenshots" must use HTTPS or point to a safe in-repo asset.

Update "screenshots" to use HTTPS or an existing relative asset path.

infobest-practicesCODEXIGNORE_MISSING

A .codexignore file helps prevent accidental inclusion of local artifacts and secrets.

Add a .codexignore file with generated assets, local state, and secret paths.

Install guidance

Install in Claude Code

Install through the Claude Code plugin marketplace.

Claude Code plugin docs

Optional: install HOL Guard for Claude Code first, so it can check this plugin's tools on your machine before Claude Code uses them.

  1. 1

    Add the marketplace

    Run this inside a Claude Code session. It registers the marketplace manifest shipped at the repository root. If the repository ships none, add the generated entry from the Advanced section below first.

    claude code
  2. 2

    Install the plugin

    Installs the hypruse entry from the hypruse marketplace.

    claude code
  3. 3

    Scripted alternative

    Non-interactive equivalent for scripts and CI pipelines. Add --scope project to pin the install to one repository.

    shell
  4. 4

    Check it is installed

    Lists installed plugins. The entry should appear as enabled.

    shell

To remove it later, run claude plugin uninstall hypruse@hypruse.

Did setup work in Claude Code?

No setup reports for Claude Code yet. Self-reported by signed-in visitors. Copying a command is not counted, and most installs are never reported.

Attested installs: Fewer than 10 attested installs of this plugin in week 2026-W46, so no number is shown. Counted from opt-in HOL Guard install reports, once per machine and runtime, and never mixed with the answers above. How install reports work.

Loading reviews

Plugin manifest

{
  "name": "hypruse",
  "version": "0.15.1",
  "description": "Computer use on Linux with Hyprland: Claude reads the window tree over IPC, takes screenshots, clicks controls by name through the accessibility tree, and drives the pointer and keyboard, with the skill that teaches the workflow. The server runs on your machine from the plugin's own source; on first start uv installs the dependency versions locked in uv.lock from PyPI, and after that it makes no network connections.",
  "author": {
    "name": "Ilyas Khallouki",
    "url": "https://github.com/IlyasKhallouki"
  },
  "homepage": "https://github.com/IlyasKhallouki/hypruse#readme",
  "repository": "https://github.com/IlyasKhallouki/hypruse",
  "license": "MIT",
  "keywords": [
    "hyprland",
    "wayland",
    "computer-use",
    "mcp",
    "desktop-automation"
  ],
  "icon": "./assets/icon.png",
  "documentationUrl": "https://github.com/IlyasKhallouki/hypruse#readme",
  "supportUrl": "https://github.com/IlyasKhallouki/hypruse/issues",
  "privacyPolicyUrl": "https://github.com/IlyasKhallouki/hypruse/blob/main/PRIVACY.md",
  "mcpServers": "./.registry/mcp.json",
  "interface": {
    "displayName": "hypruse",
    "developerName": "IlyasKhallouki"
  },
  "skills": "./",
  "holManifestOrigin": "repository",
  "registryIndexVersion": 9
}

Marketplace source

Repo URL
https://github.com/IlyasKhallouki/hypruse
Marketplace path
.claude-plugin/marketplace.json
Source path
.
Install policy
Unspecified

Skills

1 SKILL.md file ship with this plugin. Preview, copy, or download each one, then install them with the Skills CLI.

Share
skills-cli
  • hypruse

    skills/hypruse/SKILL.md

    >

    SKILL.md content is not in this snapshot. Open the raw file to copy it from the source repository.

File inventory

.claude-plugin/marketplace.json

file

629 bytes

43bf65345c34e019…

.claude-plugin/plugin.json

file

1,251 bytes

f5b9cfd50b6a9d0f…

.codex-plugin/plugin.json

plugin-manifest

1,186 bytes

2382d4dec1bad699…

.registry/mcp.json

mcp-config

136 bytes

4b00762afcdb9025…

LICENSE

file

1,432 bytes

e55b5008439c3f68…

pyproject.toml

file

2,056 bytes

b588ea17f059f962…

README.md

file

66,851 bytes

c8a504ad804685fd…

SECURITY.md

file

1,418 bytes

69b32fb9e6e874e5…

skills/hypruse/agents/openai.yaml

skill

331 bytes

607dc411bbbd58f7…

skills/hypruse/references/recipes.md

skill

20,138 bytes

b211fe8a3d2e6789…

skills/hypruse/references/verbs.md

skill

30,934 bytes

542574f5a2d0a96a…

skills/hypruse/SKILL.md

skill

12,807 bytes

3258cb8bba732450…

uv.lock

file

146,923 bytes

c6c6654b5c4a2ca1…

hypruse — Frequently asked questions

What is hypruse?
hypruse is an AI plugin in the HOL registry. MCP server: computer use on Hyprland, with workspaces, windows, mouse, keyboard and screenshots on the Wayland desktop, plus a background mode that works in other windows while your cursor and focus stay put.
How do I install hypruse?
Install hypruse in your harness: Claude Code — /plugin marketplace add IlyasKhallouki/hypruse; Cursor — npx [email protected] add IlyasKhallouki/hypruse; MCP — git clone https://github.com/IlyasKhallouki/hypruse. Full step-by-step guidance is on the HOL plugin page.
How do I install hypruse in HOL Guard?
To install hypruse in HOL Guard, start with hol-guard plugin install ilyaskhallouki/hypruse --apply. The complete step-by-step install guide for HOL Guard is on the HOL plugin page.
How do I install hypruse in Claude Code?
To install hypruse in Claude Code, start with /plugin marketplace add IlyasKhallouki/hypruse. The complete step-by-step install guide for Claude Code is on the HOL plugin page.
How do I install hypruse in Cursor?
To install hypruse in Cursor, start with npx [email protected] add IlyasKhallouki/hypruse. The complete step-by-step install guide for Cursor is on the HOL plugin page.
How is the Trust Score for hypruse computed?
hypruse has a HOL Trust Score of 78 out of 100. The score is a weighted sum of six components from a static scan of the source, capped for high-severity findings and adjusted by two disclosed policies. Memberships and payments are not inputs, and a scan is not a safety guarantee. Full breakdown: https://hol.org/registry/plugins/ilyaskhallouki%2Fhypruse/trust
Who publishes hypruse?
hypruse is published by IlyasKhallouki and listed on HOL.

Directory acceptance

Listed in 0 of 5 directory lists

Read from the list each directory publishes on GitHub. Being listed means the directory accepted the plugin; it is not a HOL security rating.

Lists last read . HOL re-reads them every day.

Submitting it? Check it against each directory's rules

Install signal

HOL cannot see every install. These are separate signals from different sources, so they are not added together. Counts under each floor show as <N.

Install commands issued here
<5
HOL Guard install commands issued from this listing, last 28 days.
Opt-in install reports
<10
Machines that reported installing it through HOL Guard in week 2026-W46. Reporting is opt-in, so most installs are not counted.
HOL Guard workspaces
<5
Workspaces that approved it or include it in an approved-plugin feed, as of today.

Reviews and similar plugins