flox-hello-binary

Canonical binary-kind reference extension for flox. This repo exists to exercise the flox extension install path for precompiled binaries shipped as GitHub release assets.

Install

flox extension install flox/flox-hello-binary
flox hello-binary world

Expected output:

Hello from hello-binary v0.1.0
args: world

Upgrade / remove

flox extension upgrade hello-binary
flox extension remove hello-binary

Platform support

v0.1.0 ships macOS assets only:

Platform	Asset
macOS, Apple Silicon	flox-hello-binary-macos-aarch64.tar.gz
macOS, Intel	flox-hello-binary-macos-x86_64.tar.gz

Linux support is tracked in PROJECTS.md as P02.

How asset resolution works

flox renders the asset template in flox-extension.toml:

[extension.binary]
source = "github-release"
asset = "flox-hello-binary-{os}-{arch}.tar.gz"

{os} / {arch} come from the host's std::env::consts::{OS,ARCH} (macos / aarch64 on Apple Silicon, macos / x86_64 on Intel). See the flox author guide for the full resolver priority order.

Links

• flox author guide — binary-kind section
• flox-hello-script — script-kind sibling reference extension

License

Apache-2.0. See LICENSE.