gui-agent

Automate desktop GUI tasks via screenshot observation, UI detection, and click/typing actions.

41|4|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/Fzkuji/GUI-Agent-Harness --skill gui-agent-fzkuji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gui-agent
Source: https://github.com/Fzkuji/GUI-Agent-Harness/tree/main
Command: npx skills add https://github.com/Fzkuji/GUI-Agent-Harness --skill gui-agent-fzkuji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openprogram, pynput, opencv-python, numpy, Pillow, ultralytics, requests, easyocr, and includes assets (resource) components.

What problem does it solve?

This Skill removes the burden of manually operating desktop applications by letting an AI agent observe your screen, identify UI elements, and perform the required clicks and typing to complete a task end-to-end.

Core Features & Use Cases

  • Visual GUI automation loop: continuously performs screenshot-based observation, verification after actions, planning, and execution until the task completes or the step limit is reached.
  • Visual memory acceleration: learns UI components for an app and reuses templates in later runs to reduce repeated detection work.
  • Local or VM/remote execution: supports running GUI actions locally or against a remote VM via a HTTP adapter (useful for OSWorld-style evaluation).
  • LLM-provider agnostic: can work with multiple LLM backends (auto-detect or force with flags).

Use it when you need the agent to perform actions like opening an application, navigating settings, filling forms, or completing benchmark-style tasks that require seeing and interacting with the screen.

Quick Start

Call the gui-agent skill with the instruction: Open Firefox and go to google.com.

Frequently Asked Questions about gui-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate desktop GUI tasks using screenshots?

Desktop GUI automation uses a screenshot-based loop to observe the screen, detect UI components via OCR and visual grounding, and execute clicks and typing to achieve a task goal end-to-end. The agent continuously verifies actions until the task completes.

Can I use visual memory to speed up GUI automation for repeated app tasks?

Yes, visual memory acceleration learns UI components for a specific app and reuses those templates in later runs. This reduces repeated detection work and speeds up task execution when interacting with familiar desktop interfaces.

Does GUI automation work with remote VM targets and OSWorld benchmark tasks?

GUI automation supports running actions locally or against a remote VM target via an HTTP adapter. This satisfies structured requirements for OSWorld benchmark-style tasks that require visual grounding and screenshot-to-detect-to-plan-to-execute looping.

What dependencies do I need for visual perception and OCR in desktop agents?

Visual perception and OCR require dependencies like OpenCV, EasyOCR, Ultralytics, and Pillow. These libraries provide the image processing, text recognition, and object detection capabilities needed to identify and interact with UI components.

Is the LLM decision making process provider-agnostic for GUI automation?

Yes, the LLM decision making process is provider-agnostic, supporting multiple LLM backends through auto-detection or forced selection via flags. This allows flexible integration of different language models for planning and executing GUI actions.

What are the limitations of screenshot-based desktop agents for UI interaction?

Screenshot-based desktop agents depend on visual clarity and may struggle with dynamic or hidden UI elements. They require sufficient step limits for complex tasks and rely on accurate OCR and object detection to correctly identify interactive components.