How do I install the Ngrok CLI skill?

Run npx skillmds@latest add grandamenium/ngrok-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ngrok CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ngrok CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ngrok CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ngrok CLI?

grandamenium (@grandamenium) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ngrok CLI by grandamenium — Agent Skill

Name: Ngrok CLI
Author: grandamenium

File contents

ngrok

Secure tunneling to localhost. Expose local servers to the internet for webhooks, demos, and testing.

Official site: https://ngrok.com
Docs: https://ngrok.com/docs

Authentication

ngrok config add-authtoken YOUR_TOKEN     # Set auth token (one-time)

Common Commands

HTTP Tunnels

ngrok http 3000                            # Tunnel to localhost:3000
ngrok http 8080                            # Tunnel to localhost:8080
ngrok http https://localhost:3000          # Tunnel to HTTPS local server
ngrok http --url=myapp.ngrok.io 3000      # Custom subdomain (paid)

TCP Tunnels

ngrok tcp 22                               # Tunnel SSH
ngrok tcp 5432                             # Tunnel PostgreSQL

Configuration

ngrok http 3000 --basic-auth="user:pass"  # Add basic auth
ngrok http 3000 --inspect=false           # Disable inspection
ngrok http 3000 --region=eu               # European region

Inspection

# Web interface at http://127.0.0.1:4040 while tunnel is running
ngrok http 3000  # Then open http://127.0.0.1:4040 for request inspector

API

ngrok api endpoints list                   # List active endpoints
ngrok api tunnels list                     # List active tunnels

Agent Best Practices

ngrok runs as a foreground process - use & or run in separate terminal
The inspection UI at localhost:4040 shows all requests (useful for webhook debugging)
Use --log=stdout --log-format=json for parseable log output
Free tier provides random URLs that change each restart
Use ngrok http for webhook testing (Stripe, GitHub, etc.)
Kill the process to close the tunnel
Parse the tunnel URL from the API: curl -s localhost:4040/api/tunnels | jq '.tunnels[0].public_url'

Example Workflows

Expose local server for webhook testing

ngrok http 3000 &
sleep 2
TUNNEL_URL=$(curl -s localhost:4040/api/tunnels | jq -r '.tunnels[0].public_url')
echo "Tunnel: $TUNNEL_URL"
# Configure webhook provider to send to $TUNNEL_URL/webhook

Expose local dev server for mobile testing

ngrok http 3000
# Share the https URL with mobile device on same network

---name: ngrok-clidescription: Use ngrok to create secure tunnels to localhost, exposing local servers to the internet for webhook testing, demos, and remote access.---# ngrokSecure tunneling to localhost. Expose local servers to the internet for webhooks, demos, and testing.- **Official site:** https://ngrok.com- **Docs:** https://ngrok.com/docs## Authentication```bashngrok config add-authtoken YOUR_TOKEN # Set auth token (one-time)```## Common Commands### HTTP Tunnels```bashngrok http 3000 # Tunnel to localhost:3000ngrok http 8080 # Tunnel to localhost:8080ngrok http https://localhost:3000 # Tunnel to HTTPS local serverngrok http --url=myapp.ngrok.io 3000 # Custom subdomain (paid)```### TCP Tunnels```bashngrok tcp 22 # Tunnel SSHngrok tcp 5432 # Tunnel PostgreSQL```### Configuration```bashngrok http 3000 --basic-auth="user:pass" # Add basic authngrok http 3000 --inspect=false # Disable inspectionngrok http 3000 --region=eu # European region```### Inspection```bash# Web interface at http://127.0.0.1:4040 while tunnel is runningngrok http 3000 # Then open http://127.0.0.1:4040 for request inspector```### API```bashngrok api endpoints list # List active endpointsngrok api tunnels list # List active tunnels```## Agent Best Practices- ngrok runs as a foreground process - use `&` or run in separate terminal- The inspection UI at localhost:4040 shows all requests (useful for webhook debugging)- Use `--log=stdout --log-format=json` for parseable log output- Free tier provides random URLs that change each restart- Use `ngrok http` for webhook testing (Stripe, GitHub, etc.)- Kill the process to close the tunnel- Parse the tunnel URL from the API: `curl -s localhost:4040/api/tunnels | jq '.tunnels[0].public_url'`## Example Workflows### Expose local server for webhook testing```bashngrok http 3000 &sleep 2TUNNEL_URL=$(curl -s localhost:4040/api/tunnels | jq -r '.tunnels[0].public_url')echo "Tunnel: $TUNNEL_URL"# Configure webhook provider to send to $TUNNEL_URL/webhook```### Expose local dev server for mobile testing```bashngrok http 3000# Share the https URL with mobile device on same network```

Frequently asked questions

Ngrok CLI