marwanhawari / stew

🥘 An independent package manager for compiled binaries.
MIT License
185 stars 14 forks source link
binaries github go package-manager releases

stew icon

stew

An independent package manager for compiled binaries.

build status go report card Coverage Status pkg.go.dev reference Mentioned in Awesome Go

Features

demo

Installation

Stew supports macOS, Linux, and Windows.

Install using a package manager

macOS ```sh brew install marwanhawari/tap/stew ```
Arch ```sh git clone https://aur.archlinux.org/stew.git cd stew makepkg -sric ```

Download a compiled binary

Compiled binaries can be downloaded from the releases page.

Install using Go

Install the latest released version ```sh go install github.com/marwanhawari/stew@latest ```
Install the latest unreleased source ```sh git clone https://github.com/marwanhawari/stew cd stew go install . ```

Usage

Install

# Install from GitHub releases
stew install junegunn/fzf              # Install the latest release
stew install junegunn/fzf@0.27.1       # Install a specific, tagged version

# Install directly from a URL
stew install https://github.com/cli/cli/releases/download/v2.4.0/gh_2.4.0_macOS_amd64.tar.gz

# Install from an Stewfile
stew install Stewfile

# Install headlessly from a Stewfile.lock.json
stew install Stewfile.lock.json

Search

# Search for a GitHub repo and browse its contents with a terminal UI
stew search ripgrep

Browse

# Browse a specific GitHub repo's releases and assets with a terminal UI
stew browse sharkdp/hyperfine

Upgrade

# Upgrade a binary to its latest version. Not for binaries installed from a URL.
stew upgrade rg           # Upgrade using the name of the binary directly
stew upgrade --all        # Upgrade all binaries

Uninstall

# Uninstall a binary
stew uninstall rg         # Uninstall using the name of the binary directly
stew uninstall --all      # Uninstall all binaries

Rename

# Rename an installed binary using an interactive UI
stew rename rg            # Rename using the name of the binary directly

List

# List installed binaries
stew list                              # Print to console
stew list > Stewfile                   # Create an Stewfile without pinned tags
stew list --tags > Stewfile            # Pin tags

Config

# Configure the stew file paths using an interactive UI
stew config           # Automatically updates the stew.config.json

FAQ

Why couldn't stew automatically find any binaries for X repo?

The repo probably uses an unconventional naming scheme for their binaries. You can always manually select the release asset.

Will stew work with private GitHub repositories?

Yes, stew will automatically detect if you have a GITHUB_TOKEN environment variable and allow you to access binaries from your private repositories.

Where does stew install binaries?

The default installation path will depend on your OS: Linux/macOS Windows
~/.local/bin ~/AppData/Local/stew/bin

However, this location can be configured.

Make sure that the installation path is in your PATH environment variable. Otherwise, you won't be able to use any of the binaries installed by stew.