gitea-release

Download and install tools from Gitea or Forgejo instance releases with automatic platform asset selection. Supports any Gitea-compatible instance including Codeberg, Forgejo, and self-hosted Gitea.

Basic Usage

import { defineTool } from "@alexgorbatchev/dotfiles";

export default defineTool((install) =>
  install("gitea-release", {
    instanceUrl: "https://codeberg.org",
    repo: "Codeberg/pages-server",
  }).bin("pages-server"),
);

Parameters

Parameter	Description
instanceUrl	Required. Base URL of the Gitea/Forgejo instance
repo	Required. Repository in “owner/repo” format
assetPattern	Glob or regex pattern to match release assets. Optional. Use only if default automatic selection fails.
assetSelector	Custom function to select the correct asset. Optional. Use only if default automatic selection fails.
version	Specific version (e.g., 'v1.2.3')
prerelease	Include prereleases when fetching latest (default: false)
token	API token for authentication with the instance
env	Environment variables (static or dynamic function)

Examples

Asset Selection (Optional)

The installer uses built-in smart selection logic by default. It parses filenames and correctly matches combinations of OS and CPU architecture (e.g. linux/darwin/macos/win/windows + amd64/arm64/aarch64/x64/x86_64).

You should ONLY provide an assetPattern or assetSelector if the default selection logic fails to find a file or downloads the wrong asset.

With Asset Pattern

install("gitea-release", {
  instanceUrl: "https://codeberg.org",
  repo: "owner/tool",
  assetPattern: "*linux_amd64.tar.gz",
}).bin("tool");

Custom Asset Selector

Use assetSelector when the repository uses non-standard asset names or when you intentionally want something other than the default smart selector. Standard Linux gnu vs musl release names are handled automatically.

install("gitea-release", {
  instanceUrl: "https://codeberg.org",
  repo: "owner/tool",
  assetSelector: ({ assets }) => {
    return assets.find((a) => a.name.endsWith("-portable.tar.gz"));
  },
}).bin("tool");

Specific Version

install("gitea-release", {
  instanceUrl: "https://codeberg.org",
  repo: "owner/tool",
  version: "v2.1.0",
}).bin("tool");

With Authentication Token

For private repositories or to avoid rate limits:

install("gitea-release", {
  instanceUrl: "https://gitea.example.com",
  repo: "org/private-tool",
  token: process.env.GITEA_TOKEN,
}).bin("tool");

Asset Pattern Matching

Pattern	Matches
*linux*amd64*.tar.gz	Linux x64 tarballs
*darwin*arm64*.zip	macOS ARM64 zips
*windows*.exe	Windows executables

Glob syntax: * (any chars), ? (single char), [abc] (char class), {a,b} (alternation)

Regex patterns can also be used by wrapping in forward slashes: /tool-v\d+.*linux/

Platform Detection

Available in assetSelector as systemInfo:

Property	Values
platform	darwin, linux, win32
arch	x64, arm64
libc	gnu, musl, unknown

Supported Instances

Any server running the Gitea API v1 is supported:

• Codeberg — Free hosting for open source projects
• Forgejo — Community fork of Gitea
• Gitea — Self-hosted Git service
• Self-hosted instances