Repository navigation
BuildFossil v0.1.0-alpha.4
Pre-releaseBuildFossil v0.1.0-alpha.4
BuildFossil is an experimental open-source CLI that captures failed Go builds into portable, verifiable capsules and replays them offline.
Highlights
Automatic Go source discovery
Capture failed builds without manually listing Go source files:
buildfossil capture --v3 --include-go-sources -- go build ./...
The new opt-in flag discovers selected main-module Go source files using offline Go package metadata.
It automatically includes go.mod and any existing go.sum.
Go embed discovery
Automatically include embedded resources together with source files:
buildfossil capture --v3 --include-go-sources --include-go-embed -- go build ./...
Expanded workspace capacity
Schema-v3 capsules now support up to 2,048 archived workspace files, including a virtual go.sum when necessary.
Security and offline replay improvements
- Disk-backed artifact handling.
- Verified workspace restoration.
- Docker snapshot lifecycle hardening.
- Improved resource cleanup and error handling.
- Cross-platform Go capture and Linux AMD64 offline replay.
Supported environments
- macOS ARM64: capture.
- Linux AMD64: capture and replay.
- Go 1.26.6.
- Docker with Linux AMD64 container execution support.
Installation
Download the appropriate archive and SHA256SUMS from this release.
Verify the SHA-256 checksum before extracting and running the binary.
Known limitations
- Experimental alpha software; not production-ready.
- Capture supports only the exact command go build ./...
- CGO, active Go workspaces and custom build tags are unsupported.
- Some Go module configurations remain unsupported.
- Source files included in capsules may contain sensitive information.
- Replay executes the recorded command; only replay trusted capsules.
Validation
- GitHub CI passed.
- Go tests and go vet passed.
- Linux Docker E2E passed.
- Tagged release candidate validation passed.
- Release artifact SHA-256 verification passed.
- Manual Capture to Docker Replay test successfully reproduced a failed Go build.
Tagged candidate validation:
https://github.com/buildfossil/buildfossil/actions/runs/38327514278