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 repair # rewrite plists + restart after upgrade
sudo bifrost tunnel uninstall <id> # remove one instance
sudo bifrost tunnel uninstall --all # remove every instance
bifrost version
LaunchDaemons use RunAtLoad + KeepAlive so agents start on boot. After reboot the agent waits for DNS, then connects with WebSocket keepalive so a dead session (Bifrost restart, sleep, network blip) reconnects instead of sitting “running” but offline.
Upgrade
pipx upgrade bifrost-agent
sudo bifrost tunnel repair
repair refreshes every installed LaunchDaemon to the new binary and restarts them — no new console token required.
list example:
a1b2c3d4e5f6
tunnel: 2
state: ● running
url: wss://bifrost.enfeca.cloud/api/v1/tunnel/connect
logs: /Library/Logs/bifrost-tunnel-a1b2c3d4e5f6.log
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
Metadata
1 maintainer
Release files for bifrost-agent 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| bifrost_agent-0.2.3.tar.gz | 10.2 kB | With provenance | Details for bifrost_agent-0.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| bifrost_agent-0.2.3-py3-none-any.whl | Python 3 | none | any | Details for bifrost_agent-0.2.3-py3-none-any.whl |
Total release size: 23.4 kB
Release files / bifrost_agent-0.2.3.tar.gz
| Download URL | bifrost_agent-0.2.3.tar.gz |
|---|---|
| Size | 10.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
feede1c6060eb2a585ee983997e425141d96af4a67a15ca5102d9441337563cc
|
|
BLAKE2b-256 checksum How to use checksums |
e27584f431a6a9d830933501f5010c95e4dfbeacdd5386c604f94ea21cc862ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logRelease files / bifrost_agent-0.2.3-py3-none-any.whl
| Download URL | bifrost_agent-0.2.3-py3-none-any.whl |
|---|---|
| Size | 13.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
337277ec1445454091113e3f1b5071c983b674a968b79eac9965dc8d7eb0d78e
|
|
BLAKE2b-256 checksum How to use checksums |
0cc9889344cc7db2d2c38a745d38174f9e6f59b1de8c39a274dfb6a7f66cc76c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logSecurity for bifrost-agent 0.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for bifrost_agent-0.2.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 2, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
