typhoon1217

Hyprland Computer Control — Development skill for Claude Code

Development community

Claude Code skill for controlling Arch Linux desktops with Hyprland (Wayland) — mouse, keyboard, windows, screenshots, volume, brightness, media, clipboard.

How to install Hyprland Computer Control

This entry records only its repository, not the path inside it, so there is no exact command to give. Open typhoon1217/hyprland-computer-control and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Hyprland Computer Control does

Claude Code skill for controlling Arch Linux desktops with Hyprland (Wayland) — mouse, keyboard, windows, screenshots, volume, brightness, media, clipboard.

Alternatives in Development

Pool Compare — Compare all Meteora DLMM pools for a token pair by APR, fee/TVL ratio, and volume 722 ★
Volume Arc — 主线拆纲 skill 669 ★
Package Assistant — Package OfficeCLI Skill as Wayland Assistant 589 ★

README

Hyprland Computer Control

Two native Wayland skills for Codex, Claude Code and other agents:

hypr-cc: control the user's existing desktop. Its real-seat input is not isolated.
hypr-ccv: test GUI flows under a separate Hyprland 0.56+ compositor with private HOME, XDG roots, Wayland/IPC, clipboard and D-Bus. Bootstrap through the existing Wayland session, then use 1–4 headless outputs.

This is GUI/profile isolation, not a container or an OS security sandbox. Commands retain the user's filesystem permissions. A nested window can briefly map during bootstrap. The controller does not install host window rules, change host monitor config, reload the host compositor or inject kernel-seat input.

Install

From this checkout:

./setup.sh --sandbox-only
# Or ./setup.sh to link both skills.
# Explicit dependency install, only if needed:
./hypr-ccv/scripts/install.sh

Installation links the canonical skill folders into `~/.agents/skills`, `~/.codex/skills` (or `$CODEX_HOME/skills`) and `~/.claude/skills`, plus CLI links in `~/.local/bin`. Existing nonmatching files/directories are preserved. Updates to this checkout therefore update every linked agent. Start a new agent session to refresh its skill catalog.

Sandbox dependencies: Hyprland with Lua config (0.56+), Python, hyprctl, wtype, grim, dbus-daemon and wayvnc. Clipboard commands need wl-clipboard; recordings need ffmpeg. `CC_VNC=0` omits pointer support. The direct-desktop `hypr-cc` skill has its own prerequisites; sandbox installation does not configure ydotool or uinput.

Isolated GUI workflow

export CC_SESSION=gui-test
hypr-ccv start 1280x800 2
hypr-ccv status
hypr-ccv run quickshell -p /path/to/test-shell
hypr-ccv hypr -j clients
hypr-ccv shot /tmp/before.png
# Inspect the image, then act on observed controls.
hypr-ccv click 640 400
hypr-ccv type 'test data'
hypr-ccv key Return
hypr-ccv keys -M ctrl -k a -m ctrl
hypr-ccv snapshot /tmp/runtime.json
hypr-ccv shot /tmp/after.pn