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
- In Bifrost Console → Tunnels, create a tunnel and attach a path route (set Local URL there, e.g.
http://127.0.0.1:3000). - 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.
You can install multiple tokens on one Mac; each gets its own LaunchDaemon and instance id.
Commands
sudo bifrost tunnel install <token> # add/replace one instance
bifrost tunnel list # id, state, url, logs path
bifrost tunnel logs <id> # last lines of that instance
bifrost tunnel logs <id> -f # follow logs
sudo bifrost tunnel uninstall <id> # remove one instance
sudo bifrost tunnel uninstall --all # remove every instance
bifrost version
list example:
a1b2c3d4e5f6
tunnel: 2
state: ● running
url: wss://bifrost.enfeca.cloud/api/v1/tunnel/connect
logs: /Library/Logs/bifrost-tunnel-a1b2c3d4e5f6.log
tunnel is the Bifrost console tunnel id. State uses a green ● when the LaunchDaemon is running, red ● when stopped.
Per-instance paths:
- Config:
/Library/Application Support/bifrost/instances/<id>/config.json - Logs:
/Library/Logs/bifrost-tunnel-<id>.log - LaunchDaemon:
com.bifrost.tunnel.<id>
A pre-0.2.0 install appears as instance id legacy.
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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bifrost_agent-0.2.2.tar.gz.
File metadata
- Download URL: bifrost_agent-0.2.2.tar.gz
- Upload date:
- Size: 8.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
085fd14c99bb278b49143f3a76c70c7d8145d160dc4fdbceea0aeb261059cdb4
|
|
| MD5 |
3edfd82dcd0b45b6659342378d984006
|
|
| BLAKE2b-256 |
ff4992af503698948e9cf7a017f8c7ad8e6f3c066e8a16fef794d695fe06ff99
|
Provenance
The following attestation bundles were made for bifrost_agent-0.2.2.tar.gz:
Publisher:
publish.yml on eskeon/bifrost-agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
bifrost_agent-0.2.2.tar.gz -
Subject digest:
085fd14c99bb278b49143f3a76c70c7d8145d160dc4fdbceea0aeb261059cdb4 - Sigstore transparency entry: 2351838741
- Sigstore integration time:
-
Permalink:
eskeon/bifrost-agent@f339ea738119ee83a53cf010ce0b789ea1617971 -
Branch / Tag:
refs/tags/v0.2.2 - Owner: https://github.com/eskeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f339ea738119ee83a53cf010ce0b789ea1617971 -
Trigger Event:
push
-
Statement type:
File details
Details for the file bifrost_agent-0.2.2-py3-none-any.whl.
File metadata
- Download URL: bifrost_agent-0.2.2-py3-none-any.whl
- Upload date:
- Size: 11.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1ef1b1eaf0e425424d00eee4401a51dc1a0614fbd7c976c12f1ffc15f4aa5d0a
|
|
| MD5 |
d19486ecb55212885f89ba1938c1af75
|
|
| BLAKE2b-256 |
6bcc63879ce6f124bcd2f38fac478aa9b11ee25e1c3b1b67e5192e185a3e78e8
|
Provenance
The following attestation bundles were made for bifrost_agent-0.2.2-py3-none-any.whl:
Publisher:
publish.yml on eskeon/bifrost-agent
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
bifrost_agent-0.2.2-py3-none-any.whl -
Subject digest:
1ef1b1eaf0e425424d00eee4401a51dc1a0614fbd7c976c12f1ffc15f4aa5d0a - Sigstore transparency entry: 2351839027
- Sigstore integration time:
-
Permalink:
eskeon/bifrost-agent@f339ea738119ee83a53cf010ce0b789ea1617971 -
Branch / Tag:
refs/tags/v0.2.2 - Owner: https://github.com/eskeon
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f339ea738119ee83a53cf010ce0b789ea1617971 -
Trigger Event:
push
-
Statement type:
