Skip to content

docs(readme): point the desktop download links at downloads.mindshub.ai (ENG-1437) - #12483

Open
lucas-koontz wants to merge 2 commits into
stagingfrom
eng-1437-downloads-mindshub-domain
Open

docs(readme): point the desktop download links at downloads.mindshub.ai (ENG-1437)#12483
lucas-koontz wants to merge 2 commits into
stagingfrom
eng-1437-downloads-mindshub-domain

Conversation

@lucas-koontz

Copy link
Copy Markdown
Contributor

Story

As a developer landing on this README for the first time
I want the install links to name the canonical download host
So that the first host I learn is the one every other surface uses

Context

ENG-437 migrated download URLs from downloads.mindsdb.com to downloads.mindshub.ai and closed as Done, but a handful of consumers were never repointed. The pick whichever fits install list here is one of them.

Nothing was broken: both names are aliases on the same CloudFront distribution, so the old links have always served the same bytes. The README is simply the first thing a new reader sees, and it was teaching the legacy host.

Only the superproject README changes. backend/core_agent is the mindsdb/anton submodule and carries the same two links in its own README. That copy is fixed in anton#340 and arrives here with the next pin bump. Editing it from inside the submodule would produce a detached commit nothing points at, which is exactly the failure mode CLAUDE.md warns about.

frontend/README.md (the mindsdb/cowork submodule) already documents the canonical host and needs no change.

Acceptance criteria

  • The superproject README.md references no downloads.mindsdb.com link.
  • Both install links resolve to a live installer on downloads.mindshub.ai.
  • Negative: no submodule pointer moves in this PR.

How to test

  1. grep -n "downloads.mindsdb.com" README.md — expect no hits.
  2. git diff --stat origin/staging...HEAD — expect README.md only, no submodule entries.
  3. Click both links in the rendered README, or check without downloading 220 MB:
    curl -sSI https://downloads.mindshub.ai/mindshub-cowork/mac/mindshub-cowork-latest.pkg | head -1
    
    It answered 200 when this was written.

Notes

The legacy alias stays live and is not being retired.

Cross-repo: part of ENG-1437, alongside open PRs on mindsdb/website (#104), mindsdb/mindshub_frontend (#1418), mindsdb/auth (#270), mindsdb/anton (#340), and mindsdb/terraform. Independent; merge order does not matter.

Refs: ENG-1437

…ai (ENG-1437)

The "pick whichever fits" install list offered the macOS and Windows desktop
builds from downloads.mindsdb.com. Both hosts are aliases of the same
CloudFront distribution so the links worked, but the README is the first thing
a new reader sees and it was teaching the legacy host.

Only the superproject README is touched. backend/core_agent is the anton
submodule and carries the same two links in its own README; that copy is fixed
in anton and arrives here with the next pin bump, so editing it from inside the
submodule would only create a detached commit nothing points at.

The legacy alias stays live and is not being retired.

Refs: ENG-1437
…437)

`docs/setup.html` is published to GitHub Pages on any push to `main` that
touches `docs/**`, and its macOS and Windows download cards still pointed at
the legacy host. This is a live user-facing CTA rather than a README link.

Host only. The `/anton/` prefix in these two URLs is deliberately left alone:
it predates the Cowork rebrand and resolves to a different, older build than
the `/mindshub-cowork/` keys every other surface uses (218446081 bytes against
220393119 for macOS). Repointing the prefix would change which installer a
visitor receives, which is a product decision and not a host migration. Raised
on ENG-1437 for a decision; ENG-1436 already owns the bucket-and-prefix
cleanup.

Both URLs verified live on the canonical host before switching: the macOS
`.pkg` is 200 at 218446081 bytes, the Windows `.exe` 200 at 106755240.

Refs: ENG-1437

@tino097 tino097 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@Dav1dF

Dav1dF commented Aug 12, 2026

Copy link
Copy Markdown

Approving. One note so the record matches the change: the description covers README.md, but the diff also repoints two download cards in docs/setup.html, and those are /anton/ paths rather than /mindshub-cowork/ ones, which the verification curls did not cover. I checked both, and downloads.mindshub.ai/anton/mac/anton-latest.pkg and /windows/anton-latest.exe each return 200. So the change is fine, the description just undersells it.

Same nit as on the other PRs in this set: the cross-repo list names a PR on mindsdb/minds, which is this repo, so it is counted twice and there is no sixth open PR.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants