cfshare_skill

Overview

This skill exposes local services, ports, files, or directories as temporary public HTTPS links using Cloudflare Quick Tunnel (trycloudflare.com). It creates short-lived, secure tunnels to a local origin, serves files with preview/download modes, and reports public_url and expiry details after each exposure. Use it to share running web apps, deliver downloads, or preview content without deploying to a remote host.

How this skill works

The skill verifies cloudflared is present, then probes the specified local origin (127.0.0.1:<port> or a temporary static file server). It launches cloudflared to open a Quick Tunnel and returns a public https://*.trycloudflare.com URL together with an expires_at timestamp. You can inspect, monitor, collect logs, and stop exposures; file exposures may be served directly, as an explorer interface, or packaged as a ZIP.

When to use it

• Share a local web app or API temporarily with teammates or testers.
• Send downloadable files or a folder snapshot without uploading to cloud storage.
• Preview static content (HTML, Markdown, PDFs, images) for non-technical reviewers.
• Demonstrate a feature during a remote meeting without changing network config.
• Troubleshoot reachability by probing end-to-end public access.

Best practices

• Always run env_check() first to confirm cloudflared and policy defaults.
• Confirm intent if sharing sensitive data; prefer authenticated alternatives for private content.
• Use short TTLs and call exposure_stop(id) when finished to terminate access.
• Prefer file preview for safe-looking content; use ZIP mode when bundling multiple files.
• If an exposure fails, fetch exposure_logs(id) for combined tunnel and origin diagnostics.

Example use cases

• Expose a local dev server on port 3000 to demo a feature to a client for 1 hour.
• Share a design folder as a browseable explorer so stakeholders can preview images and PDFs inline.
• Send a single binary as a direct download link to a contractor without attaching to email.
• Run a quick remote test on a webhook endpoint by exposing a local HTTP listener and using probe_public to verify callbacks.