Skip to content

feat(packaging): add Scoop installation support for Windows#4357

Open
lanshi17 wants to merge 1 commit into
esengine:main-v2from
lanshi17:feat/scoop-install
Open

feat(packaging): add Scoop installation support for Windows#4357
lanshi17 wants to merge 1 commit into
esengine:main-v2from
lanshi17:feat/scoop-install

Conversation

@lanshi17

@lanshi17 lanshi17 commented Jun 14, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds Scoop package manager support for Windows users, allowing installation via:

scoop bucket add reasonix https://github.com/esengine/scoop-bucket
scoop install reasonix

Changes

  • .goreleaser.yaml — added a scoops section to auto-publish the manifest to esengine/scoop-bucket on stable releases, using the same release-time publishing pattern as the existing Homebrew cask. Prereleases are skipped via skip_upload: "auto".
  • .github/workflows/release.yml — passes SCOOP_BUCKET_TOKEN to GoReleaser during the CLI release job.
  • README.md / README.zh-CN.md — added the Scoop install command to the install sections.
  • docs/RELEASING.md — documented the Scoop channel in the release channels table.

Maintainer setup required before merge

This PR depends on release infrastructure that is not part of this branch. Before merging, a maintainer with esengine organization/repository admin permissions should complete this checklist:

  1. Create the public bucket repository esengine/scoop-bucket with default branch main.
  2. Create a fine-grained PAT or GitHub App token scoped only to esengine/scoop-bucket with Contents: read/write permission.
  3. Add that token to esengine/DeepSeek-Reasonix as the Actions secret SCOOP_BUCKET_TOKEN, matching the existing HOMEBREW_TAP_TOKEN release pattern.
  4. Verify the bucket is reachable before merge:
    gh api repos/esengine/scoop-bucket --jq '{full_name,default_branch,private,html_url}'
    git ls-remote https://github.com/esengine/scoop-bucket.git HEAD

Current status checked during review: esengine/scoop-bucket returns 404, so the README install command and the next stable v* CLI release would fail until the setup above is complete.

How it works

GoReleaser generates a reasonix.json manifest from the Windows release archives (reasonix-windows-amd64.zip, reasonix-windows-arm64.zip) and their SHA256 checksums, then commits it to the bucket repo. Scoop reads this manifest to download and extract the correct binary.

Closes #4326

Add GoReleaser Scoop manifest configuration to auto-publish to
esengine/scoop-bucket on stable releases. Users install via:

    scoop bucket add reasonix https://github.com/esengine/scoop-bucket
    scoop install reasonix

The manifest is automatically updated by GoReleaser on each stable
v* tag (same as Homebrew). Prereleases are skipped (skip_upload: auto).

Closes esengine#4326
@github-actions github-actions Bot added v2 Go rewrite (1.x) — main-v2 branch, active development updater Auto-update / installer / release packaging labels Jun 14, 2026
@SivanCola

Copy link
Copy Markdown
Collaborator

@esengine this PR is directionally ready, but it needs one maintainer-owned infrastructure step before merge.

Current blocker: https://github.com/esengine/scoop-bucket is not reachable yet, so the new README install command and the next stable v* CLI release would fail until the bucket exists and GoReleaser can push to it.

Could you please complete the setup below?

  1. Create the public repository esengine/scoop-bucket with default branch main.
  2. Create a fine-grained PAT or GitHub App token scoped only to esengine/scoop-bucket with Contents: read/write.
  3. Add it to esengine/DeepSeek-Reasonix as the Actions secret SCOOP_BUCKET_TOKEN, following the existing HOMEBREW_TAP_TOKEN pattern.
  4. Confirm both checks pass:
    gh api repos/esengine/scoop-bucket --jq '{full_name,default_branch,private,html_url}'
    git ls-remote https://github.com/esengine/scoop-bucket.git HEAD

After that is done and CI remains green, I think this PR can be merged.

@JackieJK

Copy link
Copy Markdown

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

updater Auto-update / installer / release packaging v2 Go rewrite (1.x) — main-v2 branch, active development

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature]: 建议支持通过 Scoop 安装

3 participants