Skip to main content

share-server-links

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.

Source facts

Repository
ymichael/bb
Last source activity
July 14, 2026 at 04:24
Detected SKILL.md language
English
Stars
270
Forks
25

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
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. 1. 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. 2. 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. 3. 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. 4. 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.
View on GitHub