Skip to content

Releases: TimLai666/wayhand-mcp

wayhand-mcp v0.1.2

Choose a tag to compare

@TimLai666 TimLai666 released this 05 Sep 13:51

grant-screenshot.sh now always grants the host (empty) app id and the Claude desktop app id, so the installer's pre-authorization step works when run from a plain terminal. Installer replaces a running binary atomically.

wayhand-mcp v0.1.1

Choose a tag to compare

@TimLai666 TimLai666 released this 05 Sep 09:34
  • The single-instance lock now only guards the real desktop (uinput). Several Claude Code or Codex sessions can run their own server and use the sandbox target at the same time, and claude mcp list health checks connect while another session is running.
  • wayhand-mcp --version / --help.
  • Each server keeps its sandbox state in a per-process runtime directory.

Install or update:

curl -fsSL https://raw.githubusercontent.com/TimLai666/wayhand-mcp/main/scripts/install.sh | bash

wayhand-mcp v0.1.0

Choose a tag to compare

@TimLai666 TimLai666 released this 05 Sep 09:32

First release of wayhand-mcp, a local MCP server that lets Claude Code or Codex see and operate a GNOME Wayland desktop.

  • Two targets: sandbox (default, headless sway; the user's mouse and keyboard stay free) and desktop (real screen via the XDG portal, real input via uinput).
  • Tools: screen_info, screenshot, move, click, double_click, right_click, drag, scroll, key, type, calibrate, sandbox_start, sandbox_launch, sandbox_stop.
  • Safety: stdio only, no shell, SIGINT and cancellation release pressed inputs, circuit breaker, single instance, root refused.

Install:

curl -fsSL https://raw.githubusercontent.com/TimLai666/wayhand-mcp/main/scripts/install.sh | bash

Asset: x86_64 Linux tarball (binary + setup scripts), depends only on libxkbcommon.