ngrok-preview
by wynnsu
Coding Agents & IDEsBrief
Generate short-lived, mobile-friendly ngrok preview links for local artifacts and share them in Telegram.
Description
What This Skill Does
Generates temporary ngrok preview links for local task outputs (images, charts, files) and sends them via Telegram so users can view results on mobile. Links are scoped to a single task, expire after a configurable TTL, and are cleaned up after use.
Creates task-scoped, time-limited links instead of requiring manual file transfer or persistent hosting, keeping outputs isolated and auto-expiring.
When to Use It
- Sharing multiple image outputs from an agent task remotely
- Getting a quick preview link for reports while away from your desk
- Accessing local analysis results from a mobile device
- Reviewing task artifacts during a meeting without screen sharing
Example Workflow
User asks: share the chart outputs from today's analysis so I can view them on my phone
- 1
Collect chart files from the task output directory
- 2
Run ngrok_preview.py up with source paths and a session ID like tg-20260319-analysis
- 3
Extract public_url and expires_at from the returned JSON
- 4
Send the preview link and expiry notice via Telegram
- 5
Run ngrok_preview.py down after user confirms to stop and clean up the session
Temporary preview link sent via Telegram; session stopped and deleted after user confirmation
Requirements
- ngrok account (free tier at ngrok.com to obtain auth token)
- NGROK_AUTHTOKEN environment variable
Installation
clawhub install wynnsu/ngrok-previewRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.