Share localhost

One command turns localhost into a public URL. Viewers leave a voice memo right on the page. You get the transcript, ready for your agent.

stoa sharelocalhost puts a port on your laptop behind a public HTTPS URL so a teammate, designer, or customer can poke at the thing you're building. Nothing to install on their side. While they explore, they can leave a voice memo right on the page. You'll see the audio and a transcript land in the terminal where you launched the share.

For the product overview, see withstoa.com/sharelocalhost.

Quickstart

Install the CLI

brew tap specstoryai/tap
brew update
brew install stoa

Linux, WSL, and Windows builds are linked from the CLI reference.

Create an account, or log in

stoa signup    # new user: opens browser to finish signup
stoa login     # existing user: opens browser device-code flow

stoa signup creates your account and workspace in one go, then lands you back at the terminal ready to share.

Point at a local port

stoa sharelocalhost 3000

No port argument? Run stoa sharelocalhost and pick from a list of what's actually listening on your machine.

Send the URL

The CLI prints a public share URL and parks itself, listening for feedback. Press Ctrl-C to stop the share.

Public URL: https://ab12cd34ef.share.withstoa.com
Forwarding to localhost:3000

Active shares: 1/3 · Expires in 60 minutes
Listening for feedback...

What your viewer sees

The page they open is the page you're running on localhost:3000: same DOM, same JavaScript, same WebSocket connections. Hot-reload keeps working; clicking through your app feels native because it is native. No iframe, no interstitial, no login wall.

In the bottom-right corner sits a small "Leave feedback" button. Clicking it opens a panel:

Idle. A one-line nudge: "The owner will hear it and see a live transcript in their terminal."
Recording. A pulsing red dot and a M:SS timer.
Preview. A playback bar, an optional name/email field, and a Send button.
Sent. A thank-you and a "Send another" affordance.

What you see

The terminal that started the share keeps listening for new feedback. As each voice memo lands, the audio and a transcript drop into your ~/.stoa/feedback/ tree alongside a one-line notification:

[3:14:22 PM] New feedback from greg@withstoa.com (0:08)
  audio:      ~/.stoa/feedback/2026-05-05/.../15-14-22.webm
  transcript: ~/.stoa/feedback/2026-05-05/.../15-14-22.txt

The audio arrives first; the transcript shows up a second or two later. The folder layout is date-bucketed and per-share, so you can come back next week and find what someone said about your :5173 Vite app on Tuesday.

Pipe the transcript straight into Claude Code, Cursor, Codex, or whatever's building the next change.

Manage active shares

Each share holds open for an hour. Run a few in parallel and end them at any time.

stoa sharelocalhost list           # show active shares for your account
stoa sharelocalhost kill <id>      # tear down a specific share
stoa sharelocalhost kill-all       # tear down everything (asks first)
stoa sharelocalhost kill-all -f    # skip the confirmation

Ctrl-C in a foreground share also tears it down cleanly. If your laptop sleeps or your network drops, the URL serves a "this share has ended" page until you start a fresh one.

Limits


Share TTL	1 hour
Concurrent shares per user	3
Voice memo cap	25 MB per upload
Anyone with the URL	can view the proxied app and submit feedback

The URL is the capability. It's a random hex slug under *.share.withstoa.com: unguessable but ungated, so anyone you forward it to can open it. Treat it like an unlisted YouTube link. Fine for a teammate or a prospect, not for posting publicly.

FAQ

Run stoa signup (new account) or stoa login (existing). If signing in keeps failing, delete ~/.stoa/.auth.json and try again.

Three is the default cap per user. It keeps one person from exhausting the team's capacity during a marathon demo session. Need more? Reach out.

The URL stops working. Viewers see a "this share has ended" page with a link back to withstoa.com/sharelocalhost. Run stoa sharelocalhost <port> again to get a fresh URL.

Yes. Audio and transcripts are tied to your account. Only you can list or download memos for shares you created.