https://github.com/indaco/sley
CLI for semantic versioning using a simple .version file. Language-agnostic with plugins for git tagging, changelog generation, versioning policies and more.
https://github.com/indaco/sley
changelog-generator cli conventional-commits developer-tools devops git-tags golang monorepo release-automation semver version-manager versioning
Last synced: about 1 month ago
JSON representation
CLI for semantic versioning using a simple .version file. Language-agnostic with plugins for git tagging, changelog generation, versioning policies and more.
- Host: GitHub
- URL: https://github.com/indaco/sley
- Owner: indaco
- License: mit
- Created: 2025-03-23T23:53:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-20T11:32:59.000Z (about 1 month ago)
- Last Synced: 2026-02-20T15:48:42.576Z (about 1 month ago)
- Topics: changelog-generator, cli, conventional-commits, developer-tools, devops, git-tags, golang, monorepo, release-automation, semver, version-manager, versioning
- Language: Go
- Homepage: https://sley.indaco.dev/
- Size: 3.2 MB
- Stars: 23
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
sley
A semantic version orchestrator for your projects.
Documentation |
Quick Start |
CLI Reference
## Overview
sley manages [SemVer 2.0.0](https://semver.org/) versions using a simple `.version` file. It's language-agnostic, works with any stack, and integrates with Git for tagging and changelog management.
```
.version → 1.2.3
```
## Features
- **Simple** - One `.version` file, one source of truth
- **Language-agnostic** - Works with Go, Node, Python, Rust, or any stack
- **Plugin system** - Extend with built-in or custom plugins
- **Git integration** - Auto-tag releases, generate changelogs
- **Monorepo support** - Manage multiple modules independently
- **CI/CD ready** - Designed for automation pipelines
## Installation
### Homebrew (macOS/Linux)
```bash
brew install indaco/tap/sley
```
### asdf
```bash
asdf plugin add sley https://github.com/indaco/asdf-sley.git
asdf install sley latest
asdf set --home sley latest
```
### Go
```bash
go install github.com/indaco/sley/cmd/sley@latest
```
### Pre-built binaries
Download from [Releases](https://github.com/indaco/sley/releases).
## Quick Start
```bash
# Initialize in your project
sley init
# Bump the version
sley bump patch # 1.0.0 → 1.0.1
sley bump minor # 1.0.1 → 1.1.0
sley bump major # 1.1.0 → 2.0.0
# Auto-detect from conventional commits
sley bump auto
# Show current version
sley show
```
## Plugins
sley includes built-in plugins for common workflows:
| Plugin | Purpose |
| ------------------------------------------------------------------------------- | ----------------------------------------- |
| [commit-parser](https://sley.indaco.dev/plugins/commit-parser.html) | Infer bump type from conventional commits |
| [tag-manager](https://sley.indaco.dev/plugins/tag-manager.html) | Auto-create Git tags |
| [changelog-generator](https://sley.indaco.dev/plugins/changelog-generator.html) | Generate changelog from commits |
| [version-validator](https://sley.indaco.dev/plugins/version-validator.html) | Enforce versioning policies |
| [dependency-check](https://sley.indaco.dev/plugins/dependency-check.html) | Sync versions across files |
| [release-gate](https://sley.indaco.dev/plugins/release-gate.html) | Pre-bump validation checks |
See all plugins in the [documentation](https://sley.indaco.dev/plugins/).
## Configuration
Configure sley with a `.sley.yaml` file:
```yaml
plugins:
commit-parser: true
tag-manager:
enabled: true
prefix: "v"
sign: true
changelog-generator:
enabled: true
```
See the [configuration reference](https://sley.indaco.dev/reference/sley-yaml.html) for all options.
## Documentation
Full documentation is available at **[sley.indaco.dev](https://sley.indaco.dev)**:
- [What is sley?](https://sley.indaco.dev/guide/what-is-sley.html)
- [Installation](https://sley.indaco.dev/guide/installation.html)
- [Usage Guide](https://sley.indaco.dev/guide/usage.html)
- [Plugins](https://sley.indaco.dev/plugins/)
- [Extensions](https://sley.indaco.dev/extensions/)
- [CI/CD Integration](https://sley.indaco.dev/guide/ci-cd.html)
## Contributing
Contributions are welcome. See [CONTRIBUTING](CONTRIBUTING.md) for guidelines.
## License
This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.