Skip to main content
skill CX Codex

localhost-run — Claude Code skill for exposing localhost

A Claude Code skill that opens an SSH tunnel to localhost.run and publishes a local app to the internet. One command gives you a public URL, no client install and no signup on the free tier.

no license 268 installs ★ 2 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ilteoood/harness --skill localhost-run -a claude-code
Open on GitHub

What localhost-run does

The skill wraps a plain SSH tunnel: ssh -R 80:localhost:8080 localhost.run prints a https://<random>.lhr.life address that proxies HTTP and HTTPS to your local port. Keep the session open — close the terminal and the tunnel disappears.

Non-HTTP protocols go through TLS passthrough on port 443, where your app serves and validates its own certificate. This mode needs a Custom Domain; free lhr.life domains do not expose passthrough endpoints. An HTTP tunnel is easier: localhost.run issues the certificate and injects X-Forwarded-For, X-Forwarded-Host, X-Forwarded-Proto and Forwarded headers. Pass --no-inject-http-proxy-headers if another proxy already sets them.

The free tier rotates domains and has a speed limit. A Custom Domain plan costs $9 a month billed annually and gives a stable URL. WordPress breaks on rotating free domains because the site URL lives in the database — you need the paid plan or the relative-url plugin there.

What it helps with

  • share a local app with a teammate or client via a link
  • receive Stripe, GitHub or Twilio webhooks on a dev server
  • test a site from a phone or another network
  • get a stable subdomain for permanent access
  • replace ngrok, Cloudflare Tunnel or localtunnel

Example prompts for the agent

  • Expose my local server on port 8080 through localhost.run
  • Set up a tunnel for GitHub webhooks on localhost:3000
  • Tunnel PostgreSQL through a Custom Domain

How to install localhost-run

1Skills CLI (Vercel)

npx skills add ilteoood/harness --skill localhost-run -a claude-code

2Manually: put the files in place

~/.claude/skills/localhost-run/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/localhost-run/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about localhost-run

How do I install localhost-run in Claude Code?

Run npx skills add ilteoood/harness --skill localhost-run -a claude-code, then open ~/.claude/skills/localhost-run/SKILL.md.

What does localhost-run do?

It opens an SSH tunnel that puts a local HTTP, HTTPS or TLS app on the public internet. There is no client and no account for the free tier.

What is the difference between an HTTP tunnel and TLS passthrough?

An HTTP tunnel uses port 80: localhost.run issues the certificate and adds X-Forwarded-* headers. TLS passthrough on port 443 hands raw TLS bytes to your app, so you manage the certificate yourself, and it requires a Custom Domain.

Similar skills

All skills for DevOps and infrastructure →

From the same set3

Project sponsors

Companies that keep this analytics open