Bifrost

Bifrost is a local HTTPS domain proxy CLI for mapping local services (for example 127.0.0.1:5173) to stable local domains like https://testapp.bifrost, with HTTPS, host mapping, service routing, and cleanup tools built in.

Current support:

• Windows: stable
• macOS: beta
• Linux: beta (Debian/Ubuntu and RHEL/Fedora trust-store workflows)

Installation

Prerequisites

• Windows, macOS, or Linux
• Node.js 20+
• pnpm
• Elevated shell for privileged operations (hosts updates, port 80/443 listeners, cert trust)

Install from npm

pnpm install @diaval/bifrost

For global CLI usage:

pnpm install -g @diaval/bifrost

Usage

Quick start

1. Start your app locally (example: Vite on 127.0.0.1:5173).
2. Create config (optional wizard):

bifrost init

3. Start one service:

bifrost start testapp -p 5173

4. Open in browser:

https://testapp.bifrost

Config file

Use .bifrost in YAML format:

tld: bifrost
https: true
httpsRedirect: true
logMode: minimal

services:
  - domain: testapp
    host: 127.0.0.1
    port: 5173

Core commands

• bifrost start <name> -p <port>: start one service mapping
• bifrost stop [name]: stop one service or all services
• bifrost list [--json]: list active mappings
• bifrost logs [name] [-f] [--flush] [--yes]: view/follow/flush access logs
• bifrost up [--config <path>]: start all services from config
• bifrost down [--config <path>]: stop all services from config
• bifrost doctor [--fix]: diagnose and reconcile state/hosts/TLS drift
• bifrost uninstall --yes: remove managed artifacts
• bifrost daemon ps|status|kill-stale|restart: advanced daemon operations

Troubleshooting

• If domains do not resolve, run:

bifrost doctor
bifrost doctor --fix

• If daemon protocol is stale/outdated:

bifrost daemon kill-stale --yes

Then restart your service command.

Development

Project scripts

pnpm build
pnpm test
pnpm lint
pnpm format:check

Local dev loop

pnpm install
pnpm build
pnpm test

Run CLI locally:

node dist/bin/bifrost.js --help

License

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0).

Attribution and license notices must be preserved in derivative works according to MPL-2.0. See LICENSE for full text.