Github Releases

@reset/github-releasesv2026.10.22.1· MIT· 1d agoBEHAVIORSACCEPTED WARNINGS

01README

Record GitHub releases and asset downloads, and summarise them.

02Behaviors1

@reset/github-releasesv2026.10.22.1github_releases.ts

Argument	Type	Required	Description
owner	string	yes	GitHub user or organisation that owns the repository, e.g. cli
repo	string	yes	Repository name, e.g. cli for github.com/cli/cli
token?	string	no	Optional GitHub token, supplied with a vault.get expression, never a literal. Sent only as an Authorization header; omit it to read a public repository at the unauthenticated rate limit

fn sample(maxPages?: number)

Read the repository's releases from GitHub's REST API and record them as a new version, flagging releases new since the previous one

Argument	Type	Required	Description
maxPages?	number	no	Most pages of 100 releases to read, 1 to 10; 10 when omitted

fn summarise(since?: string)

Summarise the recorded samples: per release and asset the first and latest download count and the change, and total downloads

Argument	Type	Required	Description
since?	string	no	Only summarise samples recorded at or after this ISO-8601 time; all samples when omitted

releases(infinite)— One repository's releases and their assets' download counts at one moment, with the releases new since the previous version

summary(infinite)— Per release and asset the first and latest download count and the change, and the repository's total downloads

03Stats

86 / 100

Downloads

Archive size

17.8 KB

05Platforms

06Labels

04Accepted warnings1