Skip to content

BuildFossil v0.1.0-alpha.1 — First Public Alpha

Pre-release
Pre-release

Choose a tag to compare

@slambek slambek released this 11 Oct 05:38
· 59 commits to main since this release
6012404

BuildFossil 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.bfc

The 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.