agent-tunnel

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

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/yethikrishna/humble --skill agent-tunnel-yethikrishna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-tunnel
Source: https://github.com/yethikrishna/humble/tree/main/core/kortix-master/opencode/skills/KORTIX-system/agent-tunnel
Command: npx skills add https://github.com/yethikrishna/humble --skill agent-tunnel-yethikrishna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remote automation and debugging require safe, on-demand access to the user's local machine from an agent or remote controller; this skill provides a self-contained CLI to perform file IO, shell commands, UI interactions, screenshots, and clipboard operations via a secure tunnel.

Core Features & Use Cases

  • Read and write local files across the machine.
  • Run shell commands, capture screenshots, and automate UI interactions (clicks, typing, window management).
  • Access clipboard data and traverse the accessibility tree to identify UI elements for automated workflows.

Quick Start

Run bun run tunnel.ts status to verify the tunnel is online.

Frequently Asked Questions about agent-tunnel

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

FAQPage Schema
How do I securely automate remote desktop interactions on a local machine?

Secure remote desktop automation is achieved by establishing a tunnel that exposes CLI commands for shell execution, file IO, and UI interactions like clicks and typing. This enables on-demand control for debugging and automated workflows.

Can I execute shell commands and capture screenshots during remote automation?

Yes, remote automation via the tunnel allows you to execute shell commands and capture screenshots. It also supports clipboard access and file reading or writing to facilitate comprehensive debugging workflows.

Does this remote control tool require specific dependencies to manage windows?

No specific dependencies are required to manage windows. The self-contained CLI script handles window listing, app launching, and accessibility tree traversal natively, using structured permission handling to ensure safe defaults.

How do I check if my secure machine tunnel is online and ready for automation?

To verify if your secure machine tunnel is online, run the status command provided by the CLI script. This checks the connection status to ensure your local environment is ready for remote control operations.

What is the best way to interact with UI elements during remote debugging sessions?

The best approach for UI interaction during remote debugging is using the built-in tunnel client. It provides specific commands to click, type, press keys, and traverse the accessibility tree to identify elements accurately.