| name | share-server-links |
| description | Share a local HTTP server with the user over bb connect. Use when an agent has started a local HTTP server (dev server, preview, static server) and wants to hand the user a link they can open — especially remotely ("start the dev server", "let me see it", "preview", "open it on my phone", "share a link"). Prefer this over pasting localhost URLs when bb connect may be paired. |
Share local server links via bb connect
When you start an HTTP server the user should open, give them a connect share
URL — not a localhost URL. Shares work from threads running on any enrolled
host, and the command resolves the thread's host automatically.
- Check pairing: run
bb connect status --json. If not paired / not
connected, give the localhost URL and mention that bb connect enables
remote URLs once paired from the getbb.app dashboard.
- From the thread that started the HTTP server, run
bb connect expose <port>. It prints that host's share URL. Use --host <name-or-id> only
when you intentionally need another enrolled host; outside a thread,
sharing defaults to the machine running the bb server.
- Give the returned URL to the user as a markdown link. It works for viewers
who have the owner's getbb.app session; it is not a public internet link.
- When the server stops, run
bb connect unexpose <port> from the same
thread (or with the same --host) so the share is cleaned up. Use
bb connect shares [--host <name-or-id>] to inspect that host's shares.
Server-host shares use https://<server-label>--<port>.<base-domain> through
the server tunnel. Other enrolled hosts use
https://<machine-label>--<port>.<base-domain> through their daemon. If a
machine was not enrolled through Connect, expose fails with instructions to
remove and re-add it under Settings > Machines.
