# Public Tunnel

> Create temporary public tunnels to expose local application ports for demos or sharing work in progress. Use when the user asks to share a local app, create a public URL for a port, set up a tunnel, or make a local server temporarily accessible from the internet.

- **Type:** Skill
- **Install:** `agentstack add skill-sinedied-agent-skills-public-tunnel`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sinedied](https://agentstack.voostack.com/s/sinedied)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sinedied](https://github.com/sinedied)
- **Source:** https://github.com/sinedied/agent-skills/tree/main/.agents/skills/public-tunnel

## Install

```sh
agentstack add skill-sinedied-agent-skills-public-tunnel
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Public Tunnel (tunnelmole)

Create temporary public URLs that forward to local application ports using tunnelmole. No account needed, no password — just a clean public URL.

## Usage

When a user asks to expose a local port or create a public URL for a running application:

1. Confirm the local port number (must be > 1024 for security)
2. Start a tunnel using `npx tunnelmole` as a background process
3. Parse the generated `*.tunnelmole.net` URL from the output
4. Report the public URL back to the user

## Important Rules

- **Port restriction**: Only expose ports > 1024. Refuse to tunnel privileged ports (0-1024) to prevent exposing sensitive services.
- **Single tunnel per port**: Don't create duplicate tunnels for the same port.
- **No password needed**: Tunnelmole URLs are directly accessible — no IP/password prompt.

## Example

User: "Create a tunnel for my app on port 5173"

1. Start the tunnel as a background process
2. Read the output to get the `*.tunnelmole.net` URL
3. Send the user the URL

Response example:
> Your app is now publicly accessible at: `https://f38fg.tunnelmole.net`
> The tunnel will automatically close in 15 minutes.

## Implementation Notes

Run tunnelmole via `npx` as a detached background process. The URL appears in stdout after a few seconds.

```bash
# Start tunnel (run as detached background process)
npx -y tunnelmole 
```

The output contains a line like:
```
https://f38fg.tunnelmole.net is forwarding to localhost:5173
```

Parse the `https://*.tunnelmole.net` URL from the output.

To close the tunnel, kill the tunnelmole process for the corresponding port.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sinedied](https://github.com/sinedied)
- **Source:** [sinedied/agent-skills](https://github.com/sinedied/agent-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-sinedied-agent-skills-public-tunnel
- Seller: https://agentstack.voostack.com/s/sinedied
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.