SkillFoxx
Telegram

hypruse MCP

MCP-сервер и скилл дают агенту рабочий стол Hyprland: дерево окон, снимки экрана, клики по имени, мышь и клавиатура.

  • 60 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Агент получает мышь, клавиатуру, содержимое экрана и запуск приложений на вашем рабочем столе.
Все причины и проверки

ilyaskhallouki/hypruseАвтор:IlyasKhallouki

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/hypruse

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент получает мышь, клавиатуру, содержимое экрана и запуск приложений на вашем рабочем столе.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

hypruse связывает агента с рабочим столом на Hyprland без плагина композитора, root, порталов и X11. Инструмент `desktop` одним вызовом возвращает дерево мониторов, рабочих пространств и окон, а `screenshot` и `zoom` снимают экран или отдельное окно. Инструменты `ui` и `click_ui` читают дерево доступности приложений и нажимают элементы по имени, а `pointer` и `keyboard` управляют мышью и клавиатурой. В фоновом режиме агент работает в приложениях на отдельном рабочем пространстве, не двигает ваш курсор и не забирает фокус, пока вы заняты своим. Установка идет через `yay -S hypruse` или `uv tool install hypruse`, затем `hypruse init` регистрирует сервер в Claude Code, Codex или Claude Desktop и запускает проверку.

Для кого. Пользователям Linux с Hyprland или Omarchy, которые хотят отдать агенту работу в графических приложениях, пока сами продолжают работать.

Подходит, если

  • Агенту нужно настроить параметр в приложении без командной строки: включить режим «Не беспокоить» или сменить статус.
  • Нужно получить список окон по рабочим пространствам без снимков: хватает `desktop`.
  • Приложение выдает дерево доступности, и клик по имени точнее, чем по координатам.
  • Агент должен действовать в фоне, пока вы печатаете на первом рабочем пространстве.

Не подходит, если

  • Ваша среда не Hyprland: инструмент рассчитан на него.
  • Вы не готовы отдать агенту клавиатуру, мышь и содержимое экрана.
  • Задачу проще решить командой или API без графического интерфейса.

Пример запроса к агенту

Используй hypruse и покажи окна на каждом из моих рабочих пространств.

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

Работает на Hyprland и на Omarchy. Рабочее место общее: один курсор и один фокус клавиатуры, а в режиме Hyprland «фокус следует за мышью» одно движение курсора способно перенаправить нажатия, поэтому не печатайте, пока агент управляет вашим окном. Фоновый режим не гарантирует, что приложение само не выдвинет окно вперед. Доступ к элементам зависит от приложений: у части из них дерево доступности пустое, тогда остаются снимки. Перед началом прочтите раздел Security model и оставьте `pointer`, `keyboard`, `hypr` и `launch` в режиме запроса подтверждения.

Как отключить. Удалите запись `hypruse` из конфигурации клиента, затем выполните `uv tool uninstall hypruse` или удалите пакет менеджером дистрибутива. Для аварийной остановки привяжите клавишу к `hypruse stop`.

Частые вопросы

Как установить?

Выполните `yay -S hypruse` или `uv tool install hypruse`, затем `hypruse init`: команда зарегистрирует сервер в Claude Code, Codex или Claude Desktop, предварительно спросив, и запустит проверку.

Какие инструменты разрешить сразу?

Только чтение: `desktop` и `screenshot`. Инструменты `pointer`, `keyboard`, `hypr` и `launch` оставьте с подтверждением, пока не будете доверять сценарию.

Как остановить агента?

Нажмите на индикатор в `Waybar` или привяжите горячую клавишу: `bind = SUPER SHIFT, BackSpace, exec, hypruse stop`. Остановка в любой момент безопасна, удержанные кнопки мыши отпускаются.

Открывает ли сервер сетевой порт?

Нет, он работает только по stdio и не слушает сеть.

Работает ли в фоне, пока я занят?

Да, в автоматическом режиме действия над окнами вне вашего фокуса идут в фоне: курсор, фокус и рабочее пространство остаются вашими.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Свой сервер дает всем агентам общую память, поиск по коду на уровне AST и проверки перед коммитом через один MCP.

MCP-серверШирокий доступ106

Пиксельный офис в браузере: каждая сессия Claude Code или Codex сидит за столом, печатает и поднимает руку, когда ждет ответа.

ПлагинРасширенный доступ60

Панель для кодовых агентов: запускает Claude Code и Codex, ведет очередь задач и сливает проверенную работу в main.

CLIШирокий доступ119

MCP-сервер реестра HeyClaude только для чтения: агент ищет скиллы, MCP-серверы и хуки и получает готовые команды установки

MCP-серверРасширенный доступ309

MCP-сервер общей комнаты для агентов: решения, задачи с проверкой другим агентом и итоговый отчет, вход по коду.

MCP-серверРасширенный доступ107

Коротко о README

Репозиторий поставляет MCP-сервер на Python, набор команд для терминала, скилл для агента и модуль для `Waybar`. Есть интеграция для Hermes и пакеты для Arch и NixOS.

Бейдж для README

Исходный SKILL.md

---
name: hypruse
description: >
  Sees and drives the live Hyprland (Wayland) desktop through the hypruse CLI:
  lists windows and workspaces, focuses, moves, closes and launches apps over
  IPC, takes screenshots and zooms, reads GTK/Qt controls by name from the
  accessibility tree and clicks them, types text, presses shortcuts, runs the
  owner's keybinds, waits for compositor events, reads the clipboard. Use it
  whenever a task needs to look at the screen, operate a GUI application, or
  manage windows or workspaces on Hyprland (including Omarchy): "open X",
  "click the Y button", "what is on my screen", "switch to workspace 3",
  "type this into Z", "screenshot that window", "fill in this form", "close
  the terminal". Not for editing Hyprland or Omarchy config files (use the
  omarchy skill), and not for web pages when a browser tool is available.
license: MIT
compatibility: Linux with a running Hyprland session and the hypruse CLI on PATH (AUR hypruse, uv tool install hypruse, or pipx install hypruse). Needs grim and wtype; ui, marks and click_ui need an AT-SPI bus; marks needs imagemagick.
allowed-tools: Bash(hypruse doctor:*) Bash(hypruse desktop:*) Bash(hypruse screenshot:*) Bash(hypruse zoom:*) Bash(hypruse ui:*) Bash(hypruse marks:*) Bash(hypruse binds:*) Bash(hypruse wait_for:*) Bash(hypruse wait-for:*) Bash(hypruse --help) Read
metadata:
  author: IlyasKhallouki
  version: "0.15.0"
  homepage: https://github.com/IlyasKhallouki/hypruse
---

# hypruse: hands on the Hyprland desktop

Every verb is `hypruse <verb> [args]`. `hypruse --help` lists every verb and
`hypruse <verb> [<action>] --help` is the ground truth for its flags; read it
before guessing. Observation verbs print one plain line per fact; acting verbs print
one result line and exit 0 only when the action was delivered. The same
fifteen tools exist as an MCP server (`claude mcp add -s user hypruse -- uvx
hypruse`); this CLI is for agents that run shell commands.

## Before anything

```bash
hypruse doctor    # exit 0: session, event socket, pointer and grim are green
hypruse desktop   # monitors, workspaces, windows (address, class, title, at, size), active, cursor, layers
```

Read `desktop` first, every task, and act on window addresses. Never take a

Сообщить о проблеме