Skip to content

GarraIA v0.2.1 — first auto-update-ready release

Latest
Latest

Choose a tag to compare

View all tags
@michelbr84 michelbr84 released this 14 May 15:44
v0.2.1
313cf85
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

First non-prerelease tag of GarraRUST. This is the release that finally makes garraia update work end-to-end. Diagnosis: release.md. Full changelog entry: CHANGELOG.md#021---2026-05-14. Linear ticket: GAR-619. PR: #343.

What broke before

garraia update returned 404 Not Found on every install — three structural reasons fixed in this release:

  1. Every prior tag shipped as a prerelease. GitHub's /releases/latest endpoint excludes prereleases, so there was simply no release for the updater to find.
  2. ARM64 asset names were arm64, not aarch64. update.rs selects assets by std::env::consts::ARCH, which reports aarch64 on Apple Silicon and Linux ARMv8.
  3. Workflow emitted only an aggregate SHA256SUMS. update.rs:127 requires per-asset <name>.sha256 siblings.

What this release ships

Asset Platform Verified via
garraia-linux-x86_64 Linux x86_64 garraia-linux-x86_64.sha256
garraia-windows-x86_64.exe Windows x86_64 garraia-windows-x86_64.exe.sha256
garraia-macos-aarch64 macOS Apple Silicon garraia-macos-aarch64.sha256
SHA256SUMS (all of the above) aggregate file for human verification + install.sh

Coverage caveats

  • Linux ARM64: cross-compile of openssl for aarch64-unknown-linux-gnu is still in progress (tracked at GAR-370). The next release should ship it.
  • macOS x86_64 (Intel): not in this build — the macos-13 GitHub-hosted runner queue was saturated for >2h30 during this release, so the workflow's Build macOS x86_64 job never started. Released without it rather than blocking the auto-update fix indefinitely. The next release should ship it once the runner queue clears.

How to install / upgrade

# Fresh install (Linux, macOS Apple Silicon):
curl -fsSL https://raw.githubusercontent.com/michelbr84/GarraRUST/main/install.sh | sh

# Existing install — auto-update:
garraia update          # interactive
garraia update --yes    # non-interactive
garraia rollback        # revert if something goes wrong

# Manual verification (works on every platform):
sha256sum -c SHA256SUMS  # or `shasum -a 256 -c SHA256SUMS` on macOS

🤖 Published via Claude Code's /max-power workflow (release workflow was canceled mid-run due to macos-13 runner queue saturation; binaries were lifted from the workflow artifacts and re-checksummed by hand to match the release.yml output format exactly).

Desktop installer (added 2026-05-17)

Tauri MSI installer for the Garra Desktop overlay app — first MSI build since v0.1.0-beta.1 (2026-03-07). Bundles the gateway CLI (garra.exe) as a sidecar so a single install brings up both the desktop overlay and the local gateway.

Asset Platform Size Verified via
garraia-desktop_0.2.1_x64_pt-BR.msi Windows x64 (pt-BR locale) 20.7 MB garraia-desktop_0.2.1_x64_pt-BR.msi.sha256 + SHA256SUMS

Pipeline fix shipped with this MSI

scripts/build-installer.ps1 was referencing target/release/garraia.exe for the sidecar copy, but commit a1c56e8 had renamed the CLI binary to garra (name = "garra" in crates/garraia-cli/Cargo.toml). The script was patched in PR (link added at merge) to copy target/release/garra.exe → binaries/garra-x86_64-pc-windows-msvc.exe, which is what tauri.conf.json's externalBin = "binaries/garra" was always expecting.

Install

Download garraia-desktop_0.2.1_x64_pt-BR.msi, verify, then run:

# Verify (PowerShell):
(Get-FileHash garraia-desktop_0.2.1_x64_pt-BR.msi -Algorithm SHA256).Hash.ToLower()
# Compare against the value in garraia-desktop_0.2.1_x64_pt-BR.msi.sha256

Unsigned — Windows SmartScreen will warn. Click "More info" → "Run anyway".

Assets 13
Loading