Installation

Prerequisites

• Required: Git (for auto-initialization and tag-manager plugin)
• Recommended: Familiarity with semantic versioning

Choose Your Method

If you...	Use...	Requires
Use macOS/Linux with Homebrew	Homebrew	Homebrew
Want latest version system-wide	go install (global)	Go 1.25+
Need local project-specific install	go install (tool)	Go 1.25+
Use asdf version manager	asdf plugin	asdf
Don't have Go installed	Prebuilt binary	—
Want to contribute or customize	Build from source	Go, just

Homebrew (macOS/Linux)

brew install indaco/tap/sley

Install via go install (global)

go install github.com/indaco/sley/cmd/sley@latest

Install via go install (tool)

With Go 1.24 or greater installed, you can install sley locally in your project by running:

go get -tool github.com/indaco/sley/cmd/sley@latest

Once installed, use it with:

go tool sley

asdf

Install using the asdf version manager:

asdf plugin add sley https://github.com/indaco/asdf-sley.git
asdf install sley latest

Prebuilt binaries

Download the pre-compiled binaries from the releases page and place the binary in your system's PATH.

Clone and build manually

git clone https://github.com/indaco/sley.git
cd sley
just install

Verify Installation

sley --version

What's Next?

Choose your path based on your needs:

Getting started?

• Quick Start - Try sley in 30 seconds
• Usage Guide - Initialize your project and learn all commands
• What is sley? - Understand the .version file approach

Setting up configuration?

• Configuration - Configure via CLI, env vars, or .sley.yaml
• Plugin System - Enable git tagging, changelogs, and more
• .sley.yaml Reference - Complete configuration reference

Need help?

• Troubleshooting - Common issues and solutions