Run & terminal

Share an app from your computer (kodeo share, VS Code)

Give an app running on your own computer a KODEO preview link with kodeo share or VS Code's Share Port — the same access rules, viewers and request log as the browser editor.

3 min readUpdated 26 Oct 2026

An app doesn't have to run in KODEO to be shared. If it runs on your computer — a dev server, an API — share it through the same preview server.

Before you share

Share the port of an app that already works on your computer: open http://localhost:<port> in your browser first. If it's blank there, it's blank through the link too.

  • A Vite, React, Next or other framework project needs its dev server: run npm install and npm run dev, then share the port it prints (Vite's is usually 5173). Serving the project's source folder as plain files (npx serve) gives a white page — browsers can't run .jsx or .ts files until the dev server builds them.
  • For a quick test, put <h1>Hello</h1> in an index.html in an empty folder, run npx serve -l 3000 there, and share port 3000.

From the terminal

kodeo share 3000

Run it inside a linked folder (or add --project <workspace>/<project>). You get a link — and a QR code to scan with your phone — and every request is printed as it arrives, with who sent it. Ctrl+C stops sharing and ends the link.

Option
--teamWorkspace members only (the default)
--linkAnyone signed in to KODEO
--publicAnyone with the link (they see a notice first)
--password <pw>Anyone with the link and the password
--webhook [path]A webhook URL that answers only under that path
--expires 24hHow long it lasts (15m to 7d, within your plan)
--keepLeave the link when you stop (paused until you share again)

kodeo preview lists the project's live apps — one line per person and port, live, paused (the app isn't running) or offline (nobody is carrying it right now), with who is watching. kodeo preview open <id> opens one in your browser, kodeo preview qr <id> puts it on your phone (a one-time code, good for two minutes), and kodeo preview stop <id> stops one of yours — or, if you're a workspace admin, anyone's. Stopping a teammate's running app also turns off Teammates can watch it in their editor (they're told), so it doesn't come straight back. The dashboard (kodeo ui) shows live apps in its Project pane.

From VS Code

KODEO: Share Port with KODEO… (desktop VS Code) asks for the port, who can open it and for how long, and puts the link on your clipboard. It goes live within a second or two; the status bar shows who's watching, and every request (and every connection change) is written to the KODEO Preview output. Keep VS Code open — closing it, switching project or Stop ends the link. If this window can no longer carry a link, VS Code ends it on KODEO too and tells you, so nobody is left on "connecting".

The Previews view in the KODEO side bar lists the project's live apps — yours and your teammates', with their state and who's watching. Click one to watch it in KODEO Preview, beside your code: pick the app, reload, try phone, tablet and laptop sizes, see who's watching, pin comments (see Comments on the running app), copy the link or open it in your browser.

Safe by design

It only ever connects to your own computer — 127.0.0.1 (or ::1) on the port you named. No other address is reached and no redirect is followed, so nobody opening your link can use it to get into the rest of your network.

Sharing from a computer comes with Pro and Team (KODEO for VS Code 2.4.2 or later, the kodeo CLI 2.3.2 or later); a Team workspace can turn it off in Workspace settings → Previews.

Still have a question about this?

Assist answers from this article — in any language.

More in Run & terminal