# Pilot HTTP Proxy

> Route HTTP requests through Pilot Protocol tunnels. Use this skill when: 1. You need to access HTTP services behind NATs or firewalls 2. You want to proxy HTTP traffic through the Pilot overlay network 3. You're exposing local HTTP servers to remote agents Do NOT use this skill when: - Services are already publicly accessible - You need direct HTTP access on the same network - The daemon is not running

- Skill: `teoslayer/pilot-http-proxy` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add teoslayer/pilot-http-proxy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/teoslayer/pilot-http-proxy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: AGPL-3.0
- Author: TeoSlayer (https://skillmd.com/u/teoslayer)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/teoslayer/pilot-http-proxy

---


# Pilot HTTP Proxy

Route HTTP requests through Pilot Protocol tunnels using the gateway subsystem.

## Commands

### Start Gateway
```bash
pilotctl --json gateway start
```

### Map Remote HTTP Service
```bash
pilotctl --json gateway map <hostname> <local-ip>
```

### List Mappings
```bash
pilotctl --json gateway list
```

### Remove Mapping
```bash
pilotctl --json gateway unmap <local-ip>
```

### Stop Gateway
```bash
pilotctl --json gateway stop
```

## Workflow Example

```bash
#!/bin/bash
# Access remote HTTP API

pilotctl --json daemon start
pilotctl --json find api-server
pilotctl --json gateway start
pilotctl --json gateway map api-server 192.168.100.50

# Access remote service
curl http://192.168.100.50/api/v1/status
curl http://192.168.100.50:8080/metrics
```

## Port Mapping

Gateway forwards common HTTP ports:
- Port 80 (HTTP)
- Port 443 (HTTPS)
- Port 8080 (alternative HTTP)

## Dependencies

Requires pilot-protocol skill with running daemon. Root/sudo on Linux for port <1024.