mdgreenwald/Install ubi

Install the ubi CLI and optionally use it to install other tools from forge releases.

Trust Signals

workflow.ymlSHA-pinned

uses: mdgreenwald/setup-ubi@a99dc106a22da281762972de95a16a0aec80e644 # no releases — HEAD as of 2026-07-11

tags can be moved; commit SHAs can't. why a SHA?

name	description	required	default
version	The ubi version to install (e.g. `v0.9.0`). Defaults to `latest`.	no	latest
install-dir	Where ubi itself is installed. Defaults to `$HOME/.ubi/bin`.	no	""
skip-install-ubi	If `true` and ubi is already on PATH, skip installing it.	no	false
github-token	Forwarded as `GITHUB_TOKEN` to all ubi invocations.	no	${{ github.token }}
gitlab-token	Forwarded as `GITLAB_TOKEN` to all ubi invocations if set.	no	""
codeberg-token	Forwarded as `CODEBERG_TOKEN` to all ubi invocations if set.	no	""
project	Single-tool shorthand. Installs one project after ubi is on PATH.	no	""
tag	Tag for the single-tool case.	no	""
exe	`--exe` for the single-tool case.	no	""
matching	`--matching` for the single-tool case.	no	""
in	`--in` directory for both the single-tool case and each `tools` line that doesn't override it. Defaults to `$HOME/.local/bin`.	no	""
tools	Multi-line bulk install. Each non-empty, non-`#` line is passed verbatim as args to ubi.	no	""
add-to-path	Append the `in` directory to `$GITHUB_PATH` so installed tools are immediately usable. Only applies when at least one tool was requested.	no	true

name	description
ubi-path	Absolute path to the installed ubi binary.