Skip to main content

bifrost-agent

Mac path-tunnel agent for Bifrost. Connects outbound over WebSocket and exposes a local HTTP app under Bifrost’s tunnels base path (default /tunnels/{slug}).

Install

pipx install bifrost-agent
# or: pip install bifrost-agent  (inside a venv)

Requires Python 3.11+.

Connect

  1. In Bifrost Console → Tunnels, create a tunnel and attach a path route (set Local URL there, e.g. http://127.0.0.1:3000).
  2. Copy the one-time install command and run:
sudo bifrost tunnel install <token>

The token embeds the Bifrost WebSocket URL and auth secret. Local upstream URLs are not passed on the CLI — they come from the console on each request.

Commands

sudo bifrost tunnel install <token>   # LaunchDaemon + system config
bifrost tunnel list                   # show installed agent(s)
sudo bifrost tunnel uninstall         # remove daemon + system config
bifrost version

System config: /Library/Application Support/bifrost/config.json
Logs: /Library/Logs/bifrost-tunnel.log

Develop

python -m venv .venv
source .venv/bin/activate
pip install -e .
bifrost version
bifrost tunnel list

Publish

Repo: https://github.com/eskeon/bifrost-agent

Tag a release (v*); GitHub Actions builds and publishes to PyPI as bifrost-agent.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bifrost_agent-0.1.1.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bifrost_agent-0.1.1-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file bifrost_agent-0.1.1.tar.gz.

File metadata

  • Download URL: bifrost_agent-0.1.1.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bifrost_agent-0.1.1.tar.gz
Algorithm Hash digest
SHA256 6ea392788228dfec2429419c9b99c5238fa7f3509a17e2526932292c3fe31ed4
MD5 fd3914211b659ca092d06e3055ef6f0d
BLAKE2b-256 85ae8ee1e3fa8751181fdc032864db385c8c624bb2260bf6d02b4a8b5c7b408f

See more details on using hashes here.

Provenance

The following attestation bundles were made for bifrost_agent-0.1.1.tar.gz:

Publisher: publish.yml on eskeon/bifrost-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bifrost_agent-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: bifrost_agent-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bifrost_agent-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 23b30f80c49a3d526deff90111a0a93a6fe4224fe7b066e9ea175b70ea414416
MD5 05015f63eadf84295159bb36af4616c5
BLAKE2b-256 fcc575b11f1dc9f53d8a2cf2246f40b541c0a3302bc33011f972cf50fac8acfa

See more details on using hashes here.

Provenance

The following attestation bundles were made for bifrost_agent-0.1.1-py3-none-any.whl:

Publisher: publish.yml on eskeon/bifrost-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page