> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bead.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Share a running branch preview

> Share a running branch preview through an expiring application link and revoke access to a worktree service.

Share a running branch preview of one worktree application with an expiring possession link. Anyone who has the link can access that application until access ends.

## Create a link

Start the service in one terminal:

```bash theme={null}
bead worktree dev web
```

In another terminal at the same worktree root:

```bash theme={null}
bead worktree share web --ttl 24h
```

The default expiry is 24 hours; the maximum is seven days. The link applies to the bound machine and the declared application port.

## What viewers get

The browser exchanges the URL fragment token for a host-only cookie. Share the link privately and keep its fragment out of logs. Application authentication still belongs to your app.

The link grants application access. It does not grant desktop, command or file access. For desktop viewing, use [watch and human takeover](https://docs.bead.run/agents/watch-takeover.md).

## End access

```bash theme={null}
bead worktree share web --revoke
```

This revokes the binding’s saved links for `web`. Repeat the command for any other service whose links you want to revoke. Expiry, revocation, pause or machine deletion ends access. Existing edge streams close within the current grant window, at most 30 seconds. A browser may need to reconnect long-lived WebSockets.

For a private localhost forward, use [dev services](https://docs.bead.run/worktrees/services.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.