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
npx skills add ilteoood/harness --skill localhost-run -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/localhost-run/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/localhost-run/
1Skills CLI (Vercel)
npx skills add ilteoood/harness --skill localhost-run -a codex2Manually: put the files in place
.agents/skills/localhost-run/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ilteoood/harness --skill localhost-run -a cursor2Manually: put the files in place
.cursor/skills/localhost-run/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ilteoood/harness skills/core/localhost-run2Manually: put the files in place
.github/skills/localhost-run/SKILL.md1Skills CLI (Vercel)
npx skills add ilteoood/harness --skill localhost-run -a gemini-cli2Platform CLI
gemini skills install https://github.com/ilteoood/harness --path skills/core/localhost-runManually: put the files in place
.devin/skills/localhost-run/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ilteoood/harness --skill localhost-run -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.