Version & Channels

Every Stackie binary embeds its version and build metadata at compile time. Delivery channels such as edge, canary, and stable are package metadata so the same artifact can move between channels without rebuilding.

Checking Your Version

stackie --version
# stackie 0.2.0 (release, commit abc1234, built 2026-04-01T12:00:00Z)

The version string includes the build kind and the git commit hash, which is useful when reporting issues or verifying an update was applied.

Release Channels

Stackie distributes updates through three delivery channels:

Channel	Description
`stable`	Production-ready releases, recommended for most users
`canary`	Early-access builds, tested but may contain rough edges
`edge`	Earliest release channel for approved development builds

You can change your update channel in ~/.stackie/stackie.yaml:

updates:
  channel: canary

Or via the CLI:

stackie config set channel canary

Version Format

Release builds follow semantic versioning: MAJOR.MINOR.PATCH (e.g., 0.2.0). Delivery channels are not included in the artifact version. Local development builds use the format 0.2.0-dev+abc1234 where abc1234 is the git commit hash.