01
Developer Infrastructure / AI Tooling

Tunnel.Inspect.Replay.DebugwithAI.

In Development
CompanyPortZero AI
YearPortZero AI
TypeDeveloper Infrastructure / AI Tooling
RoleSystems & Full Stack Engineer
Scroll
01 — Problem Statement

Debugging API failures collaboratively is still broken despite every tool available.

Developers stitch together ngrok for tunneling, Postman for request history, webhook.site for inspection, and Slack screenshots for team collaboration — four tools to debug one API failure. Replaying a failed webhook means manually reconstructing headers and body from logs. Sharing debugging context with a teammate requires screen sharing or copy-pasting curl commands. When an intermittent production issue appears, reproducing it locally is guesswork. Each tool solves one slice of the problem and none of them talk to each other.

Key Metric latency
4+ Tools
Developers currently stitch together to debug one API failure
02 — Solution Framework

A single platform: expose → inspect → replay → AI-debug → share with team.

Built a reverse-tunnel architecture in Go where the local agent initiates a persistent outbound WebSocket connection to the gateway — all inbound public traffic rides that connection back to the local machine with no firewall rules or port forwarding. Every request transiting the tunnel is captured in full (headers, body, timing, status) and surfaced in a real-time Next.js dashboard. The replay engine stores requests byte-for-byte and can fire them against any target with exact fidelity — making intermittent failure reproduction deterministic. An OpenAI/Gemini-powered AI layer analyzes failed requests, reads headers, response codes, timing patterns, and log context to generate instant root-cause explanations. Collaborative sessions let teams share a live debugging workspace via link — no screen sharing, with inline annotations and shared replay controls.

The Hypothesis

By collapsing tunnel, inspector, replay, and AI debugging into one platform, PortZero eliminates the tool-switching overhead that turns a 5-minute debugging session into a 45-minute investigation.

Engineering Core Principle

03 — Key Features

Architectural Highlights

01

Reverse Tunnel with Persistent Socket

The local Go agent initiates an outbound persistent WebSocket/gRPC connection to the gateway — bypassing NAT, firewalls, and private IP constraints entirely. All inbound public traffic rides the existing connection back to localhost. Handles reconnection, request multiplexing across the single socket, and large payload streaming without memory buffering. One command: `portzero expose 3000` → public HTTPS URL.
02

Real-Time Request Inspector + Replay Engine

Every request transiting the tunnel is captured byte-for-byte — full headers, body, response, latency breakdown, and timeline — and surfaced in a live dashboard. The replay engine stores the complete request snapshot and can re-fire it against any target with exact fidelity: same headers, same body, same timing characteristics. Designed for reproducing intermittent failures and testing fixes against real captured webhook payloads.
03

AI Root-Cause Debugging Layer

An LLM-powered analysis layer reads failed request metadata — response codes, headers, timing patterns, error messages, and sequential request history — and generates structured root-cause explanations. Output: specific failure reason (expired JWT, upstream timeout, idempotency conflict), the evidence chain, and a suggested fix. Built to handle the class of failures that are obvious in hindsight but take 30 minutes to locate manually.
04

Collaborative Live Debugging Sessions

Share a debugging session via link — teammates join and see the same live traffic feed, can annotate individual requests inline, trigger replays, and view AI analysis outputs together. Persistent workspace means the session history survives beyond the call. Designed to replace 'share your screen and describe what you're seeing' with structured, navigable debugging context.
04 — Results & Impact

Measured outcomes.

1 Command
Localhost exposed with HTTPS public URL
Byte-exact
Request replay fidelity for failure reproduction
AI
Instant structured root-cause analysis
Zero
Screen sharing needed for team debugging
Next Case Study

Velfresh

02Velfresh