sley

sleyVersion Orchestrator

Semantic versioning with a simple .version file. Language-agnostic with plugins for git tagging, changelog generation, and more.

Get Started
View on GitHub
sley

Simple .version File

A single source of truth for your project version. Human-readable, language-agnostic, CI/CD friendly.

Powerful Plugin System

Built-in plugins for git tagging, changelog generation, version validation, and more.

Monorepo Support

Manage multiple .version files across a monorepo with pattern matching and bulk operations.

Pre-release Support

Full support for alpha, beta, and rc versions with auto-increment capabilities.

Version Policies

Enforce versioning rules, branch constraints, and release gates.

CI/CD Ready

Works seamlessly in GitHub Actions, GitLab CI, and any automated workflow.

Quick Start ​

Get up and running in seconds. Initialize your project, bump versions, and leverage plugins for git tagging and changelog management.

bash
sley init                  # interactive: select plugins, creates .version and .sley.yaml
sley init --migrate        # or pull version from existing package.json/Cargo.toml
sley show                  # prints current version

sley bump patch            # 1.2.3 -> 1.2.4
sley bump minor            # 1.2.4 -> 1.3.0
sley bump auto             # smart bump: strips pre-release or bumps patch
sley set 2.0.0 --pre beta  # set version with pre-release
sley bump pre              # 2.0.0-beta -> 2.0.0-beta.1
sley bump pre --label rc   # switch to 2.0.0-rc.1

sley tag create --push     # create and push git tag
sley changelog merge       # merge versioned changelogs into CHANGELOG.md

sley doctor                # validate setup and configuration

TIP

sley works out-of-the-box with sensible defaults. Create a .sley.yaml only when you need to customize behavior.

Next Steps ​

New to sley?

Ready to customize?

Released under the MIT License.

© 2026 indaco