---
name: Share Server Links
slug: share-server-links
category: DevOps
description: Share Server Links provides a bb connect URL that points to a local HTTP server, so users can open dev servers and previews even when the machine is remote. Use it after starting a dev server or static server when the user needs a clickable link, especially if bb connect may be paired.
github: "https://github.com/get-bb/bb/tree/main/plugins/connect/skills/share-server-links"
language: TypeScript
stars: 2274
forks: 253
install: "npx degit https://github.com/get-bb/bb/tree/main/plugins/connect/skills/share-server-links ~/.claude/skills/share-server-links"
installs_to: ~/.claude/skills/share-server-links
source_path: plugins/connect/skills/share-server-links/SKILL.md
collection_size: 14
category_size: 798
collection_url: "https://dirskills.com/collections/get-bb/bb"
added: 2026-08-18T06:58:20.766Z
last_synced: 2026-08-18T06:58:20.766Z
canonical_url: "https://dirskills.com/skills/share-server-links"
---

# Share Server Links

Share Server Links provides a bb connect URL that points to a local HTTP server, so users can open dev servers and previews even when the machine is remote. Use it after starting a dev server or static server when the user needs a clickable link, especially if bb connect may be paired.

**Install:**

```bash
npx degit https://github.com/get-bb/bb/tree/main/plugins/connect/skills/share-server-links ~/.claude/skills/share-server-links
```

## README

# 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.