Skip to content

feat: add semantic versioning and automated releases#51

Merged
stavxyz merged 5 commits into
mainfrom
feature/semantic-versioning
Jan 29, 2026
Merged

feat: add semantic versioning and automated releases#51
stavxyz merged 5 commits into
mainfrom
feature/semantic-versioning

Conversation

@stavxyz

@stavxyz stavxyz commented Jan 29, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add GITMUX_VERSION="2.0.0" to gitmux.sh with --version / -V flag support
  • Add GitHub Actions workflow to auto-create releases when version changes on main
  • Add version badges to README and docs site
  • Add just version recipe

Release workflow going forward

  1. Bump GITMUX_VERSION in gitmux.sh
  2. Create PR, merge to main
  3. GitHub Action automatically creates tagged release with notes

First release

Once merged, this will create v2.0.0 - the first release since July 2021 (198 commits ago!).

Workflow features

  • Concurrency control: Only one release workflow runs at a time
  • Manual trigger: Can be triggered via workflow_dispatch for recovery
  • Validation: Checks file exists, validates semver format
  • Idempotent: Skips if tag already exists
  • Error handling: Clear error messages if release fails

Test plan

  • ./gitmux.sh --version outputs gitmux 2.0.0
  • ./gitmux.sh -V outputs gitmux 2.0.0
  • ./gitmux.sh -h shows -V, --version option
  • just version outputs 2.0.0
  • shellcheck passes on gitmux.sh
  • All 164 bats tests pass
  • YAML workflow syntax validated

Adds version tracking for automated releases.
Running ./gitmux.sh --version now shows 'gitmux 2.0.0'.

Co-authored-by: stavxyz <hi@stav.xyz>
Creates GitHub releases automatically when GITMUX_VERSION
is updated and merged to main. Uses auto-generated release
notes from PR titles.

Co-authored-by: stavxyz <hi@stav.xyz>
Badge auto-updates when new releases are created.

Co-authored-by: stavxyz <hi@stav.xyz>
Badge displays current release version on gitmux.com.

Co-authored-by: stavxyz <hi@stav.xyz>
Run 'just version' to see current GITMUX_VERSION.

Co-authored-by: stavxyz <hi@stav.xyz>
@stavxyz stavxyz merged commit 88fb481 into main Jan 29, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant