Installation

Official artifacts require no runtime besides the binary. They are built with Go 1.26.7 and CGO_ENABLED=0.

A 0.1.0 release binary prints 0.1.0. Git tags use a v prefix (v0.1.0). Untagged local builds print 0.0.0-dev.

GitHub Releases

1. Download the archive for your OS and architecture from the v0.1.0 release.
2. Download checksums.txt from the same release and verify the archive.
3. Extract agoraform (Windows: agoraform.exe) and place it on PATH.
4. Confirm the version:

agoraform --version

File	Platform
agoraform_0.1.0_linux_amd64.tar.gz	Linux amd64
agoraform_0.1.0_linux_arm64.tar.gz	Linux arm64
agoraform_0.1.0_darwin_amd64.tar.gz	macOS amd64
agoraform_0.1.0_darwin_arm64.tar.gz	macOS arm64
agoraform_0.1.0_windows_amd64.zip	Windows amd64

Release archives also contain README.md, CHANGELOG.md, license files, and examples/agoraform.yaml.

Verify checksums

Linux:

sha256sum -c checksums.txt --ignore-missing

macOS:

shasum -a 256 agoraform_0.1.0_darwin_arm64.tar.gz
grep 'agoraform_0.1.0_darwin_arm64.tar.gz' checksums.txt

Windows PowerShell:

Get-FileHash .\agoraform_0.1.0_windows_amd64.zip -Algorithm SHA256
Select-String 'agoraform_0.1.0_windows_amd64.zip' .\checksums.txt

The two SHA-256 values must match before you run the binary.

go install

Requires Go 1.26.7 or newer:

go install github.com/dziblo-music/agoraform/cmd/agoraform@v0.1.0

Build from source

git clone https://github.com/dziblo-music/agoraform.git
cd agoraform
git checkout v0.1.0
go build -o agoraform ./cmd/agoraform
./agoraform --version

A plain untagged go build reports 0.0.0-dev. To reproduce a 0.1.0 version stamp locally:

go build -ldflags "-X github.com/dziblo-music/agoraform/internal/cli.Version=0.1.0" -o agoraform ./cmd/agoraform