home / networking / ngrok

ngrok

Official · ngrok
24k

Official ngrok CLI for exposing local HTTP, TCP, and TLS services through public tunnels with traffic inspection and endpoint controls.

$brew install ngrok
Language
Go
Stars
24,472
Category
Networking
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

ngrok CLI is ngrok's command line for putting local or private services behind secure public endpoints. It covers dev tunnels, webhook inspection, and more controlled HTTP, TCP, or TLS ingress with config and policy options.

What It Enables
  • Expose local web apps, webhook receivers, SSH servers, and other TCP or TLS services through public URLs or reserved addresses for testing, demos, and remote access.
  • Inspect tunneled HTTP traffic at the local web interface, replay captured webhook requests, and troubleshoot tunnel setup with built-in diagnostics.
  • Apply endpoint controls such as basic auth, OAuth or OIDC, IP allow or deny rules, header rewrites, webhook verification, and named config-driven tunnels.
Agent Fit
  • The command surface is useful in scripts when an agent needs temporary ingress into a local service, repeatable named tunnels from config, or direct access to ngrok account resources through ngrok api.
  • ngrok diagnose --write-report gives it a real JSON path, but most tunnel startup and runtime output is human-oriented status or logs rather than broadly structured command results.
  • Automation depends on account setup, auth tokens or API keys, and a running local target service, so unattended workflows work best after a skill standardizes config, tunnel names, and auth context.
Caveats
  • This entry currently points at the archived v1 repo, so the GitHub mapping needs a human correction before import.
  • Many useful commands establish a persistent tunnel process; they are less like quick inspect-and-exit utilities and more like session infrastructure that other tools or agents then use.