# Send Handsfree Windows Control to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "handsfree-windows-control",
    "name": "Handsfree Windows Control",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/lijinlar/handsfree-windows-control",
    "canonicalUrl": "https://clawhub.ai/lijinlar/handsfree-windows-control",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/handsfree-windows-control",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=handsfree-windows-control",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/check_setup.py",
      "scripts/setup.py",
      "references/api_reference.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "handsfree-windows-control",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T01:34:46.803Z",
      "expiresAt": "2026-05-11T01:34:46.803Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=handsfree-windows-control",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=handsfree-windows-control",
        "contentDisposition": "attachment; filename=\"handsfree-windows-control-1.3.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "handsfree-windows-control"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/handsfree-windows-control"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/handsfree-windows-control",
    "downloadUrl": "https://openagent3.xyz/downloads/handsfree-windows-control",
    "agentUrl": "https://openagent3.xyz/skills/handsfree-windows-control/agent",
    "manifestUrl": "https://openagent3.xyz/skills/handsfree-windows-control/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/handsfree-windows-control/agent.md"
  }
}
```
## Documentation

### Handsfree Windows Control

A guide skill for automating native Windows apps (UIA) and web browsers (Playwright)
via the handsfree-windows CLI.

### First use: auto-setup

On first use, run setup before issuing any other commands:

python scripts/setup.py

This will:

Clone handsfree-windows from GitHub into ~/.handsfree-windows/cli/ (public repo, read-only)
Install it via pip install -e (standard pip editable install)
Install Playwright + Chromium browser binaries (~200 MB one-time download from cdn.playwright.dev)
Run check_setup.py to verify everything is working

To skip browser installation (browser-* commands will not work):

python scripts/setup.py --no-browser

To install to a custom directory:

python scripts/setup.py --install-dir "C:\\your\\preferred\\path"

Already installed? Verify anytime:

python scripts/check_setup.py

### What is written to disk (transparent)

CLI source code: ~/.handsfree-windows/cli/ (or --install-dir)
pip editable link: standard site-packages egg-link (pip managed)
Browser persistent profiles: ~/.handsfree-windows/browser-profiles/<engine>/
Contains cookies and login sessions. Delete to reset browser auth.
Browser session state: ~/.handsfree-windows/browser-state.json (last visited URL)
Playwright browser binaries: ~\\AppData\\Local\\ms-playwright\\ (~800 MB, Windows)

To fully remove everything:

pip uninstall handsfree-windows -y
Remove-Item -Recurse -Force "$env:USERPROFILE\\.handsfree-windows"

### Core rules

Do not guess UI controls. Run hf tree or hf inspect first, then act on what is actually there.
Do not type credentials. Navigate to login screens; let the human complete auth.
Prefer UIA selectors (name + control_type) over raw coordinates.
Use drag-canvas only for canvas/ink surfaces (Paint, drawing apps, etc.).
For destructive actions (delete, submit, send), ask the human for confirmation first.

### Workflow: Desktop app (UIA)

# Launch any installed app
hf start --app "Outlook"

# Find the window
hf list-windows --json

# Discover controls (no guessing)
hf tree --title-regex "Outlook" --depth 10 --max-nodes 30000

# Act on what was found
hf click --title "Outlook" --name "New mail" --control-type "Button"

# Inspect element under cursor
hf inspect --json

### Workflow: Browser (Playwright)

# Open URL - login sessions saved in profile automatically
hf browser-open --url "https://example.com"

# Inspect page before acting
hf browser-snapshot --fmt text

# Act
hf browser-click --text "Sign in"
hf browser-type --selector "#email" --text "user@example.com"

# Verify
hf browser-screenshot --out result.png

### Mixed macro (desktop + web in one YAML)

- action: start
  args:
    app: "My Desktop App"

- action: browser-open
  args:
    url: "https://app.example.com"
    headless: false

- action: browser-click
  args:
    text: "Get Started"

- action: sleep
  args:
    seconds: 1

Run with: hf run macro.yaml

### References

Full command reference + selector schema: references/api_reference.md
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: lijinlar
- Version: 1.3.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T01:34:46.803Z
- Expires at: 2026-05-11T01:34:46.803Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/handsfree-windows-control)
- [Send to Agent page](https://openagent3.xyz/skills/handsfree-windows-control/agent)
- [JSON manifest](https://openagent3.xyz/skills/handsfree-windows-control/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/handsfree-windows-control/agent.md)
- [Download page](https://openagent3.xyz/downloads/handsfree-windows-control)