# Portal Tunnel

> Gives a local app a public HTTPS URL through self-hosted or public relays, then checks it works. No accounts, port forwarding or DNS setup.

Agent Skills from gosuda, the makers of Portal, an open-source, self-hostable tunnel that gives an app running on your machine a public HTTPS URL through relays, much like ngrok.

3 skills
- portal-expose: runs one portal expose command for your app's port, or several routes behind one name, then checks the public URL works and tells you how to keep it running or stop it. It can also put an x402 payment on a route.
- portal-connect: turns a Portal hostname or service name into the right URL, lists what's live on a relay, and makes bounded requests or probes. It reports what a paid route costs without paying.
- portal-relay: sets up your own public relay on a Linux host with Docker Compose and DNS delegation, with optional TCP and UDP ports for game servers.

Good to know
- Portal needs no account or API key. It uses a local cryptographic identity instead.
- For ordinary tunnels, TLS ends in your local Portal process, so relays only pass encrypted traffic.
- Anyone with the URL can reach what you expose, so only share what you mean to.
- You need the Portal CLI from the maker's release page. Install the skills from the maker's Claude Code plugin marketplace or with the skills CLI.
- MIT licensed.

- Type: Skill
- Made by: gosuda
- Category: Cloud & DevOps
- Formats: Skills, Claude plugins
- Version: latest
- Source: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy
- Page: https://pluginboard.ai/skills/portal-tunnel

## Works with

- ChatGPT
- Claude
- Gemini
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT: Download the portal-deploy folder and zip it, then Plugins → Skills → Create → Upload from your computer. Business and Enterprise plans.

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Claude

In Claude (web or desktop): Download each skill’s folder and zip it, then upload them one at a time in Customize → Skills.

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Gemini

In Gemini: Download the portal-deploy folder, then at gemini.google.com click Customize → Skills → Create → Upload and pick the folder (or a .zip of it).

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### GitHub Copilot

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.copilot/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.copilot/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.copilot/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Cursor

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.cursor/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.cursor/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.cursor/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Claude Code

In Claude Code, as a plugin:

```text
/plugin marketplace add gosuda/portal-tunnel
/plugin install portal-deploy@portal-tunnel
```

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.claude/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.claude/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.claude/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Codex

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.agents/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.agents/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.agents/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Antigravity

In Antigravity: Copy the portal-deploy folder into ~/.gemini/config/skills (Antigravity app and IDE) or ~/.gemini/antigravity-cli/skills (Antigravity CLI).

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Gemini CLI

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.gemini/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.gemini/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.gemini/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Replit

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect .agents/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose .agents/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay .agents/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### OpenClaw

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.openclaw/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.openclaw/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.openclaw/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### OpenCode

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.config/opencode/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.config/opencode/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.config/opencode/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

### Hermes Agent

Copy all 3 skills, in your terminal:

```shell
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-connect ~/.hermes/skills/portal-connect
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-expose ~/.hermes/skills/portal-expose
npx -y degit gosuda/portal-tunnel/plugins/portal-deploy/skills/portal-relay ~/.hermes/skills/portal-relay
```

View the skills on GitHub: https://github.com/gosuda/portal-tunnel/tree/HEAD/plugins/portal-deploy

---
From Pluginboard (https://pluginboard.ai).
