Installation

Prerequisites

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

Installation Methods

Choose the method that best fits your workflow:

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

TIP

Ensure $GOPATH/bin or $HOME/go/bin is in your PATH:

export PATH="$PATH:$(go env GOPATH)/bin"

Install via go install (tool)

Install sley locally in your project:

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

Run 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
asdf global sley latest

Prebuilt Binaries

Download pre-compiled binaries from the releases page, or use the automatic installer:

# Automatic platform detection (macOS/Linux)
curl -L https://github.com/indaco/sley/releases/latest/download/sley-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m) -o sley
chmod +x sley
sudo mv sley /usr/local/bin/

# Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/indaco/sley/releases/latest/download/sley-windows-amd64.exe" -OutFile "sley.exe"

Build from Source

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

Verify Installation

sley --version

Troubleshooting

Command not found

Issue: sley: command not found after installation.

Solution: Add the installation directory to your PATH:

# For Homebrew
export PATH="/opt/homebrew/bin:$PATH"

# For go install
export PATH="$PATH:$(go env GOPATH)/bin"

# For manual binary
export PATH="/usr/local/bin:$PATH"

Permission denied

Issue: permission denied when running sley.

Solution: Make the binary executable:

chmod +x sley
sudo mv sley /usr/local/bin/

Version mismatch

Issue: sley --version shows old version after upgrade.

Solution: Clear shell cache and verify installation:

hash -r
which sley

macOS Gatekeeper warning

Issue: "sley cannot be opened because the developer cannot be verified".

Solution: Remove quarantine attribute:

xattr -d com.apple.quarantine /usr/local/bin/sley

go install fails

Issue: go install fails with "permission denied" or "cannot find module".

Solution: Verify Go installation and clean module cache:

go version  # Should be 1.25+
go clean -modcache
go install github.com/indaco/sley/cmd/sley@latest

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
• Environment Variables - Configure via environment