sharelocalhost.mp4
Built by SpecStory, makers of Stoa, so you can ship a half-finished feature, hand a friend a link, and hear what they actually thought without spinning up staging or shipping a PR preview. One command turns localhost into a public URL, your viewer leaves a voice memo on the page, and the transcript lands in your terminal ready for your agent.
Install the Stoa CLI ──▶
Connect with us ───▶
🎙️ Read the docs for the full reference, or jump straight to installation.
Your dev server Stoa CLI Public viewer
─────────────── ──────── ─────────────
(no login, no install)
localhost:PORT ──► stoa sharelocalhost ──► https://abc123.share.withstoa.com
(live for 1 hour) (records voice memo)
▲ │
└────── transcript ────────┘
~/.stoa/feedback/
(agent-ready)
- Install. Run
brew tap specstoryai/tap && brew install stoa. One binary. A free Stoa account is required to share. - Run one command.
stoa sharelocalhostlists your running dev servers. Pick one. You get a public URL back, live for one hour. - Hand over the link. Viewers open it on their own machine. A small button sits in the corner of every page. They click, record a voice memo, send.
- Hear the feedback. Audio and transcript stream back to your terminal and drop into
~/.stoa/feedback/next to the original recording. - Pipe it to your agent. Hand the transcript file straight to Claude Code, Cursor, Codex, or whatever's building the next change.
| Platform | Source | Install | Min Version |
|---|---|---|---|
| macOS / Linux (Homebrew) | Closed | brew tap specstoryai/tapbrew updatebrew install stoa |
v0.7.0+ |
| Direct download | Closed | See docs.withstoa.com/reference/cli#installation | v0.7.0+ |
| Other package managers | Closed | See docs.withstoa.com/reference/cli#installation | v0.7.0+ |
Note
A free Stoa account is required to share. Sign in once, then stoa sharelocalhost from any project.
# 1. Install
brew tap specstoryai/tap
brew install stoa
# 2. Start your dev server (anything works)
npm run dev # or pnpm dev, bun dev, rails s, uvicorn, etc.
# 3. Share it
stoa sharelocalhost # interactive: pick from running servers
stoa sharelocalhost 3000 # or pass the port directly
# → https://abc123.share.withstoa.com
# Listening for feedback. Press Ctrl+C to stop.When a viewer records a voice memo, audio and transcript appear in your terminal and land in:
~/.stoa/feedback/
├── 2026-05-05T14-22-31_abc123.mp3
└── 2026-05-05T14-22-31_abc123.txt
Pipe the .txt straight to your agent of choice.
ngrok and Cloudflare give you a public URL. stoa sharelocalhost gives you the URL and the feedback loop.
stoa sharelocalhost |
ngrok | Cloudflare | |
|---|---|---|---|
| Free account to share | ✅ | ✅ | ❌ |
| Voice memo capture | ✅ | ❌ | ❌ |
| Auto-transcription | ✅ | ❌ | ❌ |
| Agent-ready transcript file | ✅ | ❌ | ❌ |
| Feedback in your terminal | ✅ | ❌ | ❌ |
| WebSocket / HMR | ✅ | ✅ | ✅ |
A public URL is the start. The feedback loop is the point.
stoa sharelocalhost is the smallest piece of a much bigger loop. Stoa runs the same loop across your whole team. Every meeting, every agent run, every change in the codebase, captured as it happens and kept next to the work. The full version is multiplayer AI for teams.
- 📚 Full Documentation: guides, reference, and API
- 🛠️ CLI Reference: every command and flag
- 🎙️
stoa sharelocalhostdocs: deeper guide for this feature - 🐛 Report a bug or request a feature: open an issue in this repo. We triage and respond here.
- 📨 Contact: hello@withstoa.com
Tip
This repo is the home for stoa sharelocalhost issues and feature requests. Found a bug, hit a rough edge, or have an idea for what should ship next? Open an issue and we'll see it.
Using stoa sharelocalhost? Tag @specstoryai on X with what you're shipping. We read everything.