Versioning policy
Oncebolna-cli reaches 1.0, releases will follow Semantic Versioning (SemVer): MAJOR.MINOR.PATCH.
Major. Breaking changes that are backward incompatible (renaming commands, changing flag names, changing output shapes).
Minor. New features that are backward compatible (new commands, new optional flags).
Patch. Backward-compatible bug fixes.
During beta (0.x.y), any release may include breaking changes — check the Changelog before upgrading in CI.
Platform support
The CLI is a single static Go binary, buildable for macOS, Linux, and Windows on botharm64 and x86_64.
Best practices
- Check the version after upgrading – Run
bolna versionto confirm what’s installed. - Review the changelog before upgrading – Skim the Changelog for behavior changes, especially during beta.
- Pin the version in CI – Since
go install ...@latestalways resolves to the newest commit, pin an explicit tag or commit in CI pipelines to avoid unexpected differences across environments.
Open source
bolna-cli is open source, hosted on GitHub. We welcome contributions — fork the repo, open a Pull Request, and we’ll review it. See Installation.
