winuse 0.2.1

winuse 0.2.1 is a small follow-up to 0.2.0: every MCP tool now declares its annotation hints, so MCP hosts can tell at a glance which tools only observe and which can change or destroy something.

Changes

• Tool annotations on all 48 tools. Every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint explicitly. Hosts that confirm before destructive or open-world calls (Claude Code, Codex CLI, Copilot CLI, ...) get a real answer per tool instead of a default.
  • Tools that act on the live desktop are open-world; where a single call can trigger anything in the target app (act, click, drag, type_text, press_keys, invoke, window_close, process_run, process_kill, scenario_run) they are destructive.
  • File tools stay inside the allowed roots and are closed-world; write_text, copy, move, delete, unzip and scenario_save are destructive because they can replace existing files.
  • Observation, find / check, wait_for and the assert_* tools are read-only.

No behaviour of the tools themselves changed. Scenarios recorded with 0.2.0 replay unchanged.

Install

1. Install the .NET 10 runtime (or SDK).
2. Unzip winuse-0.2.1-win-x64.zip into a folder.
3. Register with Claude Code: claude mcp add winuse -- <folder>\winuse.exe --mcp
4. Set JEV_API_KEY, or CLOUDFLARE_ACCOUNT_ID and CLOUDFLARE_API_TOKEN, as user environment variables, then run winuse doctor.

Upgrading from 0.2.0: unzip over the old folder and restart the AI client.

Known issues

Unchanged from 0.2.0: get_table does not read Swing tables yet; a JRE without the Java side of the bridge cannot be read; type_text with Japanese text can be garbled under the Japanese IME (intermittent).

Full changelog: CHANGELOG.md