Skip to content

Patch/v0.2.5#28

Merged
digitallysavvy merged 5 commits into
mainfrom
patch/v0.2.5
Jun 1, 2026
Merged

Patch/v0.2.5#28
digitallysavvy merged 5 commits into
mainfrom
patch/v0.2.5

Conversation

@digitallysavvy
Copy link
Copy Markdown
Contributor

Summary

  • Add install.sh --replace-npm to migrate from a global npm-managed agoraio-cli install to the standalone
    installer.
  • Improve managed-install errors with explicit uninstall and reinstall guidance.
  • Document the v0.2.5 installer migration changes and update release examples to use the next patch tag.

Details

The installer still refuses to overwrite package-manager-managed installs by default to avoid PATH shadowing. For
npm-managed installs, users now have two clear paths:

  • Manual migration:
    npm uninstall -g agoraio-cli
    curl -fsSL https://raw.githubusercontent.com/AgoraIO/cli/main/install.sh | sh

  • Convenience migration:
    curl -fsSL https://raw.githubusercontent.com/AgoraIO/cli/main/install.sh | sh -s -- --replace-npm

--force remains available, but the docs now frame it as intentional side-by-side installation only.

Verification

  • sh -n install.sh
  • sh scripts/test-installer-messages.sh
  • git diff --check
  • Fake npm dry-runs for:
    • default npm-managed install error guidance
    • --replace-npm dry-run migration path

  Add --replace-npm so users with a global npm-managed agoraio-cli can
  uninstall it before installing the standalone binary.

  Improve managed-install guidance to show manual uninstall and reinstall
  steps, and clarify that --force is only for intentional side-by-side
  installs.
  Document the v0.2.5 installer migration changes and record the
  v0.2.3/v0.2.4 release history.

  Update release examples to use the next patch tag.
@digitallysavvy digitallysavvy requested a review from plutoless June 1, 2026 20:01
@digitallysavvy digitallysavvy self-assigned this Jun 1, 2026
@digitallysavvy digitallysavvy added the enhancement New feature or request label Jun 1, 2026
@digitallysavvy digitallysavvy merged commit ffde6f7 into main Jun 1, 2026
7 checks passed
@digitallysavvy digitallysavvy deleted the patch/v0.2.5 branch June 1, 2026 21:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant