Repository navigation
BuildFossil v0.1.0-alpha.1 — First Public Alpha
Pre-releaseBuildFossil v0.1.0-alpha.1
First Public Alpha
Capture a failed build. Replay the failure offline.
BuildFossil is an experimental open-source CLI that captures failed software builds into portable .bfc capsules and replays them in isolated Docker environments.
What's included
- Capture failed Go builds into portable, verifiable capsules.
- Replay schema-v3 capsules in an isolated Linux AMD64 environment.
- Support explicitly included workspace files and a restricted set of verified Go module dependencies.
- Compare exit codes and stderr to determine whether a failure was reproduced.
- Run replay with restricted container privileges and network isolation.
- Verify capsule integrity before replay.
Supported platforms
- macOS ARM64 (Apple Silicon)
- Linux AMD64
Docker is required for replay.
Installation
Download the archive for your platform, extract it, and check the version:
./buildfossil version
Expected output:
buildfossil v0.1.0-alpha.1
Quick start
Capture a failed Go build:
CGO_ENABLED=0 GOFLAGS='' GOWORK=off GOOS=linux GOARCH=amd64 buildfossil capture --v3 --include go.mod --include go.sum --include main.go -- go build ./...Replay the failure:
buildfossil replay --v3 --allow-command failure.bfcThe capture command must be run from a compatible Go project. Adjust --include paths to match your project.
Verify downloads
Download SHA256SUMS alongside the archive and verify its SHA-256 checksum before use.
Alpha limitations
- This is experimental software and is not production-ready.
- The supported Go build workflow is deliberately restricted.
- Reproduction is not guaranteed for every failure or dependency configuration.
- Replay currently targets Linux AMD64.
- Docker and the required replay environment must be available.
- macOS binaries are not Developer ID signed or notarized. Gatekeeper may require explicit approval.
- Do not replay untrusted capsules without reviewing the security implications.
Feedback
Issues and reproducible bug reports are welcome:
https://github.com/buildfossil/buildfossil/issues
This is the first public alpha, intended for early evaluation and feedback.