skills.rest
ArsalanKhan04
ArsalanKhan04COMMUNITY
Explore all skills by this author →
GitHub

limbs

Launch and automate GUI apps in a Docker-isolated Xcode sandbox via Python host interactions.

Updated Mar 8, 2026
Search Tags:#automation#docker#interaction#screenshot#gui#window-manager#xvfb
One-click install
npx skills add https://github.com/ArsalanKhan04/limbs --skill limbs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: limbs
Source: https://github.com/ArsalanKhan04/limbs/tree/main/.claude/skills/limbs
Command: npx skills add https://github.com/ArsalanKhan04/limbs --skill limbs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GUI applications often require a full desktop environment and complex setup. limbs provides a Docker-isolated sandbox with a virtual X11 display (Xvfb) and i3 window manager, enabling automated control from Python on the host.

Core Features & Use Cases

  • Run GUI apps inside a reproducible container with deterministic display
  • Automate interactions (click, type, screenshot) from Python on the host
  • Manage container lifecycle (bootstrap, start, stop, restart) and health checks for stable automation
  • Optional templates: prebuilt images and reusable components to speed up setup

Quick Start

Call container_ensure_running() to bootstrap the limbs sandbox, then use screenshot() and find_and_click() to interact with your GUI apps.

Frequently Asked Questions about limbs

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

FAQPage Schema
How do I automate GUI applications in Docker without a physical display?▼

You can automate GUI applications in Docker by using an isolated sandbox with a virtual Xvfb display. This setup allows you to run and control graphical apps programmatically from the host without needing a physical monitor attached.

Can I take screenshots and send clicks to a GUI app running inside an Xvfb sandbox?▼

Yes, you can take screenshots and send clicks to a GUI app inside an Xvfb sandbox. Host-driven Python interactions operate the application by clicking, typing, and capturing the screen across active sessions.

What is the best way to manage the lifecycle of a Docker container used for GUI automation?▼

The best way to manage a Docker container for GUI automation is using built-in lifecycle controls. You can bootstrap, start, stop, and restart the sandbox while running health checks to ensure stable, reproducible automation environments.

Does automating GUI apps with Xvfb require a full desktop environment on the host?▼

No, automating GUI apps with Xvfb does not require a full host desktop environment. The sandbox uses a Docker-isolated virtual X11 display and an i3 window manager, providing a deterministic display entirely within the container.

How do I start automating a windowed application inside a reproducible container?▼

To start automating a windowed application, call the container bootstrap function to ensure the sandbox is running. Once active, use Python functions to screenshot the display and find and click elements to interact with your app.

Related Skills

Explore More Software Engineering Skills→
hhopkins95hhopkins95
2

Backend Setup

Configure a Node.js agent-runtime backend with REST and WebSocket servers.

Community
Advanced
Chris-MaskeyChris-Maskey

slack

Automate Slack web sessions to check unreads, navigate channels, and extract conversation data.

Community
Intermediate
lolwierdlolwierd
1

surf

Automate Chrome-based browser workflows via CLI for testing and debugging.

Community
Advanced
aztr0nutzsaztr0nutzs
2

computer-use

Creates a virtual display for GUI control of headless Linux servers.

Community
Advanced