skills.rest
aimentor606
aimentor606COMMUNITY
Explore all skills by this author →
GitHub

agent-tunnel

Execute shell commands and file operations on a local machine via an API-backed tunnel.

Updated Apr 8, 2026
Search Tags:#accessibility#screenshots#shell#file-io#remote-execution#desktop-automation#agent-tunnel
One-click install
npx skills add https://github.com/aimentor606/aether --skill agent-tunnel-aimentor606
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-tunnel
Source: https://github.com/aimentor606/aether/tree/main/core/kortix-master/opencode/skills/KORTIX-system/agent-tunnel
Command: npx skills add https://github.com/aimentor606/aether --skill agent-tunnel-aimentor606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable safe, programmatic access to a user's local machine so an AI or automation agent can read/write files, run shell commands, capture screenshots, and interact with GUI elements without manual step-by-step user intervention.

Core Features & Use Cases

  • File I/O: Read, write, and list files and directories on the user's computer.
  • Remote Command Execution: Run shell commands with controlled timeouts and receive structured stdout/stderr results.
  • Desktop Automation: Capture screenshots and cursor regions, move/click/drag the mouse, type text, and press key combinations.
  • Accessibility-driven UI Automation: Inspect the accessibility tree, search UI elements, focus elements, set values, and trigger AX actions for reliable cross-resolution interactions.
  • Operational Safety: Uses an API-backed tunnel with permission requests, JSON outputs for deterministic parsing, and explicit error messages for offline or permission states.
  • Use Case Example: Troubleshoot a user issue by listing open windows, taking a screenshot, locating a button via the accessibility tree, and triggering a click or AXPress to reproduce and fix the problem.

Quick Start

Take a screenshot of my desktop, list open windows, and read the file at ~/Documents/report.txt.

Frequently Asked Questions about agent-tunnel

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

FAQPage Schema
How do I automate desktop interactions and run shell commands remotely?▼

Desktop automation and remote shell command execution are handled through a secure API-backed tunnel that provides structured JSON outputs for deterministic parsing and configurable command timeouts.

Can I use the accessibility tree for UI automation instead of relying on screenshots?▼

Accessibility tree UI automation allows you to inspect elements, search UI components, focus elements, set values, and trigger AX actions to achieve reliable, cross-resolution interactions without depending on screenshots.

How do I securely read and write files on a local machine without manual intervention?▼

Secure file reading and writing on a local machine is achieved through an API-backed tunnel that enforces permission approval requests before an AI agent can access or modify local directories.

What's the best way to capture screenshots and control mouse input for GUI automation?▼

Capturing screenshots and controlling mouse input requires utilizing the desktop automation API, which stores temporary screenshot files and executes cursor movements, clicks, and drags based on structured JSON RPC commands.

Does remote execution stop if the local machine goes offline or denies permission?▼

Remote execution explicitly stops and returns structured error messages when the local machine enters an offline state or when the user denies a permission request through the API-backed tunnel.

Are there limitations when running shell commands with configurable timeouts?▼

Configurable timeouts limit shell command execution duration, returning structured stdout and stderr results immediately upon timeout expiration to prevent hanging during remote automation tasks.

Related Skills

Explore More Software Engineering Skills→
RheasilviaRheasilvia

pinggy-tunnel

Expose local network services to the public internet via SSH-based reverse tunneling.

Community
Intermediate
kendreadityakendreaditya

gemini-convo

Parse Gemini conversation JSON files into readable Markdown transcripts.

Community
Intermediate
simnovasimnova
18

apollo-mcp-server

Expose GraphQL operations as MCP tools via Apollo MCP Server.

Official
Intermediate
yethikrishnayethikrishna

agent-tunnel

Expose local machine automation commands via a self-contained CLI tunnel.

Community
Advanced