Repository navigation
Releases
REW v0.1.0-alpha.6 — Portable .rew Capsules
REW v0.1.0-alpha.6
Experimental open-source CLI for capturing failed Go builds into portable, verifiable capsules and reproducing failures offline in isolated Linux containers.
Highlights
- New
.rewfilename extension for schema-v3 capsules. - Backward-compatible reading of existing
.bfccapsules. rew auditfor integrity verification and limited sensitive-data checks before sharing.- Improved schema-v3 capture security checks for sensitive paths and environment variables.
- Support for Go 1.25.14 and Go 1.26.6 (exact patch versions).
- Automatic Go source and supported
//go:embedresource discovery. - Real-world Go-Task and TOML capture/replay CI coverage.
- Offline Linux AMD64 Docker replay with pinned Go toolchains.
Downloads
- macOS ARM64:
rew_v0.1.0-alpha.6_darwin_arm64.tar.gz - Linux AMD64:
rew_v0.1.0-alpha.6_linux_amd64.tar.gz - Checksums:
SHA256SUMS
Verify the downloaded archive against SHA256SUMS before extracting.
Requirements
- Supported Go toolchain: Go 1.25.14 or Go 1.26.6.
- Supported capture command:
go build ./.... - Docker capable of running Linux AMD64 containers for replay.
- Access to the pinned Docker replay image if not already cached.
Security
This is experimental alpha software, not production-ready.
Replay executes code from the capsule and requires explicit authorization. Do not replay untrusted capsules. Container isolation and SHA-256 verification do not establish capsule trust or authenticity.
The rew audit command performs limited checks; zero findings do not mean a capsule is safe to share.
See README.md, SECURITY.md and docs/limitations.md for supported scope and restrictions.
Compatibility
Previously published alpha releases remain available. Existing .bfc schema-v3 capsules remain readable. New schema-v3 captures use .rew.
REW v0.1.0-alpha.5 — First REW Alpha
REW v0.1.0-alpha.5
The first REW-branded alpha release.
REW is an open-source CLI for capturing failed Go builds into portable, verifiable .bfc capsules and replaying them offline using Docker.
What's included
rewCLI for macOS ARM64 and Linux AMD64.- Failed Go build capture and schema-v3 capsule verification.
- Offline Go replay using Docker-managed workspace and dependency snapshots.
- SHA-256 integrity verification and bounded resource usage.
- Cross-platform capture and replay tests.
- Docker replay image hosted at
ghcr.io/rewtools/replay-baseand pinned by digest.
Installation
Download the archive for your platform, extract rew, and place it on your PATH.
Verify the archive with the accompanying SHA256SUMS file.
Requirements
- Docker for replay.
- Supported Go runtime: Go 1.26.6.
- Platform and replay limitations are documented in the repository.
Security and limitations
Experimental alpha software.
- Do not execute capsules from untrusted sources.
- Capsule integrity verification does not authenticate the capsule creator.
- Arbitrary command replay requires explicit opt-in.
- Replay does not guarantee identical outcomes across all environments.
- Schema-v3 replay uses Docker-managed snapshots rather than host workspace bind mounts.
- The tool is not a general-purpose CI job recorder.
See SECURITY.md and docs/security-model.md for the supported threat model.
Historical BuildFossil alpha releases remain available for reference.
BuildFossil v0.1.0-alpha.4
BuildFossil 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
BuildFossil v0.1.0-alpha.3
BuildFossil v0.1.0-alpha.3
BuildFossil is an experimental open-source CLI for capturing failed software builds and replaying them offline.
What's new
- Expanded compatibility with larger real-world Go projects.
- Disk-backed artifact storage and streamed schema-v3 processing.
- SHA-256 verification of stored build artifacts.
- Docker-managed snapshot volumes for isolated offline replay.
- Additional security hardening against workspace path replacement and artifact publication failures.
- Expanded unit, integration, and Docker E2E test coverage.
Validation
- GitHub CI: 14/14 PR and push checks passed.
- Tagged release candidate workflow: passed.
- Real-world Go-Task v3.40.1 failed build: reproduced offline.
- Both release archives independently verified against SHA256SUMS.
Downloads
- macOS Apple Silicon:
buildfossil_v0.1.0-alpha.3_darwin_arm64.tar.gz - Linux AMD64:
buildfossil_v0.1.0-alpha.3_linux_amd64.tar.gz - SHA-256 checksums:
SHA256SUMS
Limitations
This is experimental alpha software, not a production-stability guarantee.
Offline replay requires Docker and the appropriate runtime image. Supported capture and replay scenarios are limited to the documented workflows. Security hardening has been tested but has not undergone an independent security audit.
See README.md and the project documentation for usage and known limitations.
BuildFossil v0.1.0-alpha.2 — Second Public Alpha
BuildFossil v0.1.0-alpha.2
Second Public Alpha
Capture a failed build. Replay the failure offline.
BuildFossil is an experimental open-source CLI for capturing failed Go builds into portable, verifiable .bfc capsules and reproducing them in isolated Docker environments.
What's changed
Capture Go projects without go.sum
Schema-v3 capture now supports dependency-free Go projects that do not contain a go.sum file.
- Automatically embeds an empty
go.suminside the capsule when no external Go modules are selected. - Does not create or modify
go.sumin the original project. - Preserves existing dependency integrity checks.
- Rejects existing
go.sumfiles omitted from the capture includes.
More reliable Docker integration testing
Improved snapshot rollback testing to verify cleanup of only the Docker volumes belonging to the tested operation.
This reduces false-positive failures caused by concurrent tests using the same Docker daemon.
Implemented in PR #25.
Supported platforms
- macOS ARM64 (Apple Silicon)
- Linux AMD64
Docker is required for replay.
Quick start
Capture a failed build from a Go project without external dependencies:
CGO_ENABLED=0 GOFLAGS='' GOWORK=off GOOS=linux GOARCH=amd64 \
buildfossil capture --v3 \
--include go.mod \
--include main.go \
-- go build ./...Replay the captured failure:
buildfossil replay --v3 --allow-command failure.bfcBuildFossil supports a restricted Go 1.26.6 workflow. Adjust included source files to match your project.
Download verification
Download the archive for your platform alongside SHA256SUMS, then verify its checksum before extracting it.
Validation
This release was validated by GitHub Actions, including Go tests, static analysis, Docker integration testing, and cross-platform binary builds.
Release source commit:
f084207468d2b14b2ce0d4516f00a9f7320b2a0e
Alpha limitations
- Experimental software; not production-ready.
- Replay currently targets Linux AMD64.
- Capture supports a restricted set of Go build configurations and external dependencies.
- Docker is required for replay.
- Reproduction is not guaranteed for every build failure.
- macOS binaries are not Developer ID signed or notarized and may require explicit Gatekeeper approval.
- Do not replay untrusted capsules without assessing the security implications.
Feedback
Report bugs and share reproducible failure cases:
https://github.com/buildfossil/buildfossil/issues
Thank you for testing BuildFossil.
BuildFossil v0.1.0-alpha.1 — First Public Alpha
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.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.