Bifrost

Secure localhost sharing for Wheelocity development.

Open the canonical Markdown guide

# Bifrost

Bifrost publishes an already-running localhost HTTP service through Cloudflare. Stable URLs are public; only machine enrollment is restricted to Wheelocity accounts.

## Install on macOS

```bash
curl -fsSL https://bifrost.wheelocity.dev/install.sh | bash
```

The installer downloads and verifies the universal macOS binary, installs it at `~/.local/bin/bifrost`, asks for a machine name, opens your default browser for `@wheelocity.com` authentication, and installs the persistent per-user agent.

## Use

```bash
# Foreground; Ctrl+C removes the public route.
bifrost expose api --port 3000

# Multiple copies of a service.
bifrost expose api --instance blue --port 3001

# Deliberately keep a route after the terminal closes.
bifrost expose web --port 5173 --detach

bifrost list
bifrost status
bifrost stop web
bifrost doctor

# Temporary random trycloudflare.com URL; no setup required.
bifrost quick --port 3000
```

Stable hostnames use `bf-<machine>-<service>[-<instance>].wheelocity.dev`. Bifrost does not start your application and currently exposes HTTP localhost ports only.

## Agent reference

- Canonical Markdown: https://bifrost.wheelocity.dev/README.md
- Installer: https://bifrost.wheelocity.dev/install.sh
- Health: https://bifrost.wheelocity.dev/health
- CLI help: `bifrost help`