{"id":13786757,"url":"https://github.com/marwanhawari/stew","last_synced_at":"2025-05-11T22:33:30.112Z","repository":{"id":37533488,"uuid":"453831330","full_name":"marwanhawari/stew","owner":"marwanhawari","description":"🥘 An independent package manager for compiled binaries.","archived":false,"fork":false,"pushed_at":"2025-05-06T21:32:22.000Z","size":19759,"stargazers_count":261,"open_issues_count":6,"forks_count":15,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-06T22:32:22.875Z","etag":null,"topics":["binaries","github","go","package-manager","releases"],"latest_commit_sha":null,"homepage":"https://stew.sh","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/marwanhawari.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-01-30T23:43:46.000Z","updated_at":"2025-05-06T21:32:26.000Z","dependencies_parsed_at":"2024-01-05T21:46:02.830Z","dependency_job_id":"f2369243-f278-4b0f-9b71-3429ccd1889e","html_url":"https://github.com/marwanhawari/stew","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwanhawari%2Fstew","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwanhawari%2Fstew/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwanhawari%2Fstew/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marwanhawari%2Fstew/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marwanhawari","download_url":"https://codeload.github.com/marwanhawari/stew/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253645441,"owners_count":21941315,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["binaries","github","go","package-manager","releases"],"created_at":"2024-08-03T19:01:34.122Z","updated_at":"2025-05-11T22:33:30.088Z","avatar_url":"https://github.com/marwanhawari.png","language":"Go","funding_links":[],"categories":["Software Packages","Go","package-manager","软件包","\u003ca name=\"package-manager\"\u003e\u003c/a\u003ePackage managers","Go Tools"],"sub_categories":["Other Software","其他软件"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg width=30% height=auto src=\"https://github.com/marwanhawari/stew/raw/main/assets/stew.png\" alt=\"stew icon\"/\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003estew\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n  An independent package manager for compiled binaries.\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\n  \u003ca href=\"https://github.com/marwanhawari/stew/actions/\"\u003e\n    \u003cimg src=\"https://github.com/marwanhawari/stew/actions/workflows/test.yml/badge.svg\" alt=\"build status\"/\u003e\n  \u003c/a\u003e\n  \n  \u003ca href=\"https://goreportcard.com/report/github.com/marwanhawari/stew\"\u003e\n    \u003cimg src=\"https://goreportcard.com/badge/github.com/marwanhawari/stew\" alt=\"go report card\"/\u003e\n  \u003c/a\u003e\n\n  \u003ca href='https://coveralls.io/github/marwanhawari/stew?branch=main'\u003e\n    \u003cimg src='https://coveralls.io/repos/github/marwanhawari/stew/badge.svg?branch=main' alt='Coverage Status'/\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://pkg.go.dev/github.com/marwanhawari/stew\"\u003e\n    \u003cimg src=\"https://pkg.go.dev/badge/github.com/marwanhawari/stew.svg\" alt=\"pkg.go.dev reference\"/\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/avelino/awesome-go\"\u003e\n    \u003cimg src=\"https://awesome.re/mentioned-badge.svg\" alt=\"Mentioned in Awesome Go\"/\u003e\n  \u003c/a\u003e\n  \n\u003c/p\u003e\n\n\n# Features\n* Install binaries from GitHub releases or directly from URLs.\n* Easily distribute binaries across teams and private repositories.\n* Get the latest releases ahead of other package managers.\n* Rapidly browse, install, and experiment with different projects.\n* [Configure](https://github.com/marwanhawari/stew?tab=readme-ov-file#configuration) where to install binaries.\n* No need for `sudo`.\n* Just a single binary with 0 dependencies.\n* Portable [`Stewfile`](https://github.com/marwanhawari/stew/blob/main/examples/Stewfile) with optional pinned versioning.\n* Headless batch installs from a [`Stewfile.lock.json`](https://github.com/marwanhawari/stew/blob/main/examples/Stewfile.lock.json) file.\n\n![demo](https://github.com/marwanhawari/stew/raw/main/assets/demo.gif)\n\n# Installation\nStew supports macOS, Linux, and Windows.\n\n### Install using a package manager\n\u003cdetails\u003e\n  \u003csummary\u003emacOS\u003c/summary\u003e\n\n  ```sh\n  brew install marwanhawari/tap/stew\n  ```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eArch\u003c/summary\u003e\n\n  ```sh\n  git clone https://aur.archlinux.org/stew.git\n  cd stew\n  makepkg -sric\n  ```\n\u003c/details\u003e\n\n### Download a compiled binary\nCompiled binaries can be downloaded from the [releases page](https://github.com/marwanhawari/stew/releases).\n\n### Install using Go\n\u003cdetails\u003e\n  \u003csummary\u003eInstall the latest released version\u003c/summary\u003e\n\n  ```sh\n  go install github.com/marwanhawari/stew@latest\n  ```\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003eInstall the latest unreleased source\u003c/summary\u003e\n\n  ```sh\n  git clone https://github.com/marwanhawari/stew\n  cd stew\n  go install .\n  ```\n\u003c/details\u003e\n\n# Usage\n### Install\n```sh\n# Install from GitHub releases\nstew install junegunn/fzf              # Install the latest release\nstew install junegunn/fzf@0.27.1       # Install a specific, tagged version\n\n# Install directly from a URL\nstew install https://github.com/cli/cli/releases/download/v2.4.0/gh_2.4.0_macOS_amd64.tar.gz\n\n# Install from an Stewfile\nstew install Stewfile\n\n# Install headlessly from a Stewfile.lock.json\nstew install Stewfile.lock.json\n\n# Install multiple binaries per repo/asset\nstew install astral-sh/uv     # Install uv the first time\nstew install astral-sh/uv     # Install uvx the second time\n```\n\n### Search\n```sh\n# Search for a GitHub repo and browse its contents with a terminal UI\nstew search ripgrep\nstew search fzf user:junegunn language:go    # Use GitHub search syntax\n```\n\n### Browse\n```sh\n# Browse a specific GitHub repo's releases and assets with a terminal UI\nstew browse sharkdp/hyperfine\n```\n\n### Upgrade\n```sh\n# Upgrade a binary to its latest version. Not for binaries installed from a URL.\nstew upgrade rg           # Upgrade using the name of the binary directly\nstew upgrade --all        # Upgrade all binaries\n```\n\n### Uninstall\n```sh\n# Uninstall a binary\nstew uninstall rg         # Uninstall using the name of the binary directly\nstew uninstall --all      # Uninstall all binaries\n```\n\n### Rename\n```sh\n# Rename an installed binary using an interactive UI\nstew rename rg            # Rename using the name of the binary directly\n```\n\n### List\n```sh\n# List installed binaries\nstew list                              # Print to console\nstew list \u003e Stewfile                   # Create an Stewfile without pinned tags\nstew list --tags \u003e Stewfile            # Pin tags\n```\n\n### Config\n```sh\n# Configure the stew file paths using an interactive UI\nstew config           # Automatically updates the stew.config.json\n```\n\n# Configuration\n`stew` can be configured with a `stew.config.json` file. The location of this file will also depend on your OS:\n|Linux/macOS | Windows |\n| ------------ | ---------- |\n| `$XDG_CONFIG_HOME/stew` or `~/.config/stew` | `~/AppData/Local/stew/Config` |\n\nYou can configure 2 aspects of `stew`:\n1. The `stewPath`: this is where `stew` data is stored.\n2. The `stewBinPath`: this is where `stew` installs binaries\n3. `excludeFromUpgradeAll`: this is the list of binaries that you don't want to be upgraded during `stew upgrade --all`, perhaps because they have their own built in upgrade feature or because you want to pin a specific version.\n\nThe default locations for the `stewPath` and `stewBinPath` are:\n|                    | Linux/macOS | Windows |\n| ------------ | ------------ | ---------- |\n| `stewPath` | `$XDG_DATA_HOME/stew` or `~/.local/share/stew` | `~/AppData/Local/stew` |\n| `stewBinPath` | `~/.local/bin` | `~/AppData/Local/stew/bin` |\n\nThere are multiple ways to configure these:\n* When you first run `stew`, it will look for a `stew.config.json` file. If it cannot find one, then you will be prompted to set the configuration values.\n* After `stew` is installed, you can use the `stew config` command to set the configuration values.\n* At any time, you can manually create or edit the `stew.config.json` file. It should have values for `stewPath`, `stewBinPath`, and `excludeFromUpgradeAll`. \n\nMake 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`.\n\n# FAQ\n### Why couldn't `stew` automatically find any binaries for X repo?\nThe repo probably uses an unconventional naming scheme for their binaries. You can always manually select the release asset.\n\n### Will `stew` work with private GitHub repositories?\nYes, `stew` will automatically detect if you have a `GITHUB_TOKEN` environment variable and allow you to access binaries from your private repositories.\n\n### I'm hitting the GitHub API rate limit when installing from a large `Stewfile.lock.json`. How can I avoid this?\nUnauthenticated GitHub API requests are limited to 60 requests per hour. However, authenticated requests can make up to 5,000 requests per hour. To avoid hitting the limit, set a `GITHUB_TOKEN` environment variable. `Stew` will automatically detect it and use it for authenticated GitHub API requests.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarwanhawari%2Fstew","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarwanhawari%2Fstew","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarwanhawari%2Fstew/lists"}