Git Buoy 0.1.0

Git Buoy 0.1.0

Git Buoy 0.1.0 is the first packaged release of the local-first terminal harbor. It observes branches, linked worktrees, changed files, synchronization state, conflicts, and in-progress Git operations in one repository, with exact details available in inspect mode.

Supported release assets

Platform	Architecture	Archive
macOS	Apple Silicon (aarch64)	git-buoy-v0.1.0-macos-aarch64.tar.gz
Linux	x86-64 with glibc	git-buoy-v0.1.0-linux-x86_64.tar.gz
Windows	x86-64	git-buoy-v0.1.0-windows-x86_64.zip

Git and an interactive terminal are required. The core local harbor does not require a GitHub account, network access, or an AI provider.

GitHub pull requests, reviews, checks, and published releases are optional. To enable them, install and authenticate the gh CLI, then run git-buoy --github path/to/repository. Failure of the optional GitHub observer does not stop local repository observation.

Verify the download

Each archive has a companion .sha256 asset. Download both files into the same directory, then run one of these commands.

Linux:

sha256sum --check git-buoy-v0.1.0-linux-x86_64.tar.gz.sha256

macOS:

shasum -a 256 --check git-buoy-v0.1.0-macos-aarch64.tar.gz.sha256

Windows PowerShell:

$expected = (Get-Content git-buoy-v0.1.0-windows-x86_64.zip.sha256).Split()[0]
$actual = (Get-FileHash -Algorithm SHA256 git-buoy-v0.1.0-windows-x86_64.zip).Hash.ToLowerInvariant()
if ($actual -ne $expected) { throw "checksum mismatch" }

The checksums detect an incomplete or altered download; the v0.1 binaries and checksum files are not code-signed.

After extracting the archive, confirm the executable reports git-buoy 0.1.0 with git-buoy --version (or .\git-buoy.exe --version on Windows).

Known limitations

• Git Buoy observes one local repository at a time and does not perform Git operations such as staging, committing, merging, rebasing, or pushing.
• Live events are inferred from consecutive surveys and local evidence. Changes that begin and end between surveys can be missed, and some reference movement can only be described as updated.
• GitHub is the only optional hosting adapter. Fork and deleted-head metadata can limit how a pull request is associated with a dock.
• The v0.1 release provides archives, a crates.io package, and an Apple Silicon Homebrew formula rather than native installers. Its binaries and checksums are not signed.
• Terminal colors inherit the user's palette in ANSI 16-color mode; condition words remain the authoritative non-color signal.