Snowbeam 0.2.0a3 — simpler inventory labels

Snowbeam 0.2.0a3

The tree heading is Organizations and the CLI inventory heading is Accounts.
Empty-state guidance and synthetic app captures use the same wording.

This release changes labels only. Organization/account aliases, notes, connection
settings, and local inventory retain their existing behavior and storage format.

On macOS, use Updates → Check now → Update and restart in the official Homebrew
installation, or close Snowbeam and run:

brew update
brew upgrade reunionstudio/tap/snowbeam

For a new macOS installation, use brew install reunionstudio/tap/snowbeam.
On Linux or Omarchy with uv, install or upgrade with:

uv tool install --reinstall https://github.com/reunionstudio/snowbeam/releases/download/v0.2.0a3/snowbeam-0.2.0a3-py3-none-any.whl

This remains an alpha. The previous release validation
documents the tested update path and integration limits. Live Snowflake and vault
validation, hosted Linux CI, and actual Omarchy desktop validation remain pending.

Snowbeam 0.2.0a2 — organization and account aliases

Snowbeam 0.2.0a2

Give your Snowflake organizations and accounts names you recognize, plus local notes.
For example, FLXH5C4T can appear as Acme Accounting LLC.

Select an organization or account in the left tree and choose Alias / notes
(n). Save a friendly name and multiline notes. The inventory shows those names;
real Snowflake identifiers remain in details and are still used for connections
and clipboard copies. Identity search also matches aliases.

The CLI edits the same local records:

snowbeam labels organization FLXH5C4T --alias "Acme Accounting LLC"
snowbeam labels account FLXH5C4T-PROD --notes "Review access before monthly close."

Use identifiers already present in your inventory. Labels require no network
access, change no Snowflake objects or permissions, and do not alter connection
configuration. Keep credentials in your vault, never in notes.

Install or upgrade

On macOS with Homebrew:

brew install reunionstudio/tap/snowbeam
snowbeam --demo

If already installed through the official tap, open Updates, check for this
release, and choose Update and restart. Manual upgrades also work with
brew update and brew upgrade reunionstudio/tap/snowbeam while Snowbeam is closed.

On Linux or Omarchy with uv:

uv tool install --reinstall https://github.com/reunionstudio/snowbeam/releases/download/v0.2.0a2/snowbeam-0.2.0a2-py3-none-any.whl
snowbeam --demo

See the user guide for controls,
CLI flags, field limits, and storage paths. Existing profiles and local inventory
survive the upgrade. Opening this version upgrades the inventory database to
schema 4; earlier versions will reject it. Back up local state before downgrading.
Aliases and notes live in this database and are removed if it is deleted.

Validation and limits

Tests use isolated synthetic data and fake Snowflake responses. The feature covers
storage migration, refresh/restart persistence, recognized account renames,
distinct account identities, field validation, CLI editing, and the actual terminal
forms, including keyboard use at 80 × 24. See the
validation record for completed release checks.

This remains an alpha. Live Snowflake provisioning, real vault writes, cloud
workload authentication, hosted Linux CI, and an actual Omarchy desktop remain
unvalidated. Linux installation uses a portable Python wheel; no AUR package or
macOS DMG is included. Local inventory and notes are private to the filesystem
user but are not encrypted or synced between devices. JSON inventory exports
include aliases and notes.

Snowbeam 0.2.0a1 — first public alpha

Snowbeam 0.2.0a1

Alpha release. This is an evaluation release for a dedicated test
account, with a synthetic demo that needs no credentials.

Snowbeam makes many Snowflake connections and individual agent identities easier
to organize across organizations and accounts. It is a local Python terminal
application for Linux and macOS, built first for Omarchy, and licensed under MIT.

Included

Connection and identity inventories; client/owner/runtime labels; PAT metadata and
attention; policy evidence; reviewed managed-agent lifecycle plans; 1Password and
Bitwarden adapters; existing workload-identity bindings; runtime handoffs; CLI/JSON
commands; optional desktop launchers and reminders; and the pixel Snowbeam logo.
Includes configurable background refresh with persisted failure backoff, an
Updates panel with optional daily release checks, and Homebrew packaging tools.
Official Homebrew installations offer Update and restart with progress,
verification, and automatic reopening after the user's click. Other installations
show manual instructions. Release checks never install updates automatically.

Snowflake enforces access, vaults hold managed secrets, and an external runtime
runs the agent. Snowbeam does not provide OS isolation or provision cloud IAM.

Install

On macOS with Homebrew:

brew install reunionstudio/tap/snowbeam
snowbeam --demo

Or, with uv installed, from the directory containing the downloaded release wheel:

uv tool install ./snowbeam-0.2.0a1-py3-none-any.whl
snowbeam --version
snowbeam --demo

The source archive is snowbeam-0.2.0a1.tar.gz. The release includes checksums and
the generated formula used by the Homebrew tap.
Omarchy and other Linux users can follow the uv installation guide;
AUR packaging remains pending.
No DMG is included. Snowflake CLI and provider CLIs are separate
prerequisites for live workflows. See the README for installation,
upgrade, uninstall, and first-use behavior.

Validation and known limits

• Local macOS ARM64 checks passed on Python 3.11, 3.13, and 3.14: 124 isolated
  tests on each version. See the validation record.
• Automated account/provider tests use synthetic responses and isolated files.
• The wheel and source archive are checked in clean temporary environments,
  including command discovery, package version, bundled icon, demo inventory,
  and headless terminal startup.
• Linux and macOS CI templates cover Python 3.11, 3.13, and 3.14. They are not
  enabled: GitHub authorization for workflow changes is pending. This alpha is
  checked locally; hosted Linux CI and live Omarchy validation remain pending.
• Local Homebrew install/upgrade and wheel upgrade trials retained synthetic
  configuration, token metadata, and operation history. The Homebrew trial used
  existing dependencies and a disposable revision; full dependency installation
  on a clean Mac and Intel macOS testing remain pending.
• The in-app installer and restart flow have isolated tests. A live button update
  between two published official-tap versions remains pending.
• Live Snowflake provisioning, real 1Password/Bitwarden writes, cloud workload
  authentication, and a real Omarchy desktop remain pending.
• macOS launchd and Linux systemd/desktop behavior have isolated tests; actual
  scheduler and notification delivery need manual validation.
• Runtime reports supplied by an operator are not signed Snowflake attestations.
• The metadata cache is not encrypted. Existing secrets in Snowflake configuration
  remain in that configuration and its backup. Forced termination can leave
  restricted temporary credential files requiring cleanup.

Earlier local builds reported 0.2.0; no stable 0.2.0 was published. Reinstall the
chosen alpha artifact explicitly when moving from that private development build.

For issues, include the package and platform versions with a sanitized reproduction.
Report credential exposure and access-control problems through SECURITY.md.