[Bug]: npx does not use the latest version of the codemod

[trivikr]

Describe the bug

npx does not use the latest version of codemod

Steps to reproduce

To reproduce, you need to have an older version of aws-sdk-js-codemod installed

$ npm view aws-sdk-js-codemod version 
0.6.3

$ npx aws-sdk-js-codemod --version
aws-sdk-js-codemod: 0.6.1
...

Run the following commands:

$ npx aws-sdk-js-codemod@latest --version

$ npx aws-sdk-js-codemod --version

Observed behavior

When latest is explicitly passed, it uses the latest version.
But it does not override the previously installed version

$ npx aws-sdk-js-codemod@latest --version
Need to install the following packages:
  aws-sdk-js-codemod@0.6.3
Ok to proceed? (y) y
aws-sdk-js-codemod: 0.6.3
...

$ npx aws-sdk-js-codemod --version 
aws-sdk-js-codemod: 0.6.1
...

Expected behavior

Default documentation should update how to use the latest version.

The current usage recommends npx aws-sdk-js-codemod which will use the catched version: https://github.com/awslabs/aws-sdk-js-codemod#usage

[trivikr]

This seems to be the default behavior of npm CLI as discussed in npm/cli#2329

We can recommend running aws-sdk-js-codemod@latest in README, but that will ask user to install CLI every time it's run, as that version is not cached.

$ npx aws-sdk-js-codemod@latest --version
Need to install the following packages:
  aws-sdk-js-codemod@0.6.3
Ok to proceed? (y) y
aws-sdk-js-codemod: 0.6.3
...

$ npx aws-sdk-js-codemod@latest --version
Need to install the following packages:
  aws-sdk-js-codemod@0.6.3
Ok to proceed? (y) y
aws-sdk-js-codemod: 0.6.3
...

[trivikr]

We'll probably add an FAQ to README requesting users to clear their npm cache.

Example gist https://gist.github.com/karlhorky/3e092d1def377f409976566db2e46029

We may also request user to run npx clear-npx-cache which clears npx cache programatically.

[trivikr]

A message can be added in --help section which is displayed by default.

Existing output

$ npx aws-sdk-js-codemod --help
-----------------------------------------------------------------------------------------------
aws-sdk-js-codemod is a lightweight wrapper over jscodeshift.
It processes --help, --version and --transform options before passing them downstream.

You can provide names of the custom transforms instead of a local path or url:

     v2-to-v3  Converts AWS SDK for JavaScript APIs in a Javascript/TypeScript codebase from 
               version 2 (v2) to version 3 (v3). 

Example: aws-sdk-js-codemod -t v2-to-v3 example.js

-----------------------------------------------------------------------------------------------
...

The new section could be:

$ npx aws-sdk-js-codemod --help
-----------------------------------------------------------------------------------------------
aws-sdk-js-codemod is a lightweight wrapper over jscodeshift.
It processes --help, --version and --transform options before passing them downstream.

You can provide names of the custom transforms instead of a local path or url:

     v2-to-v3  Converts AWS SDK for JavaScript APIs in a Javascript/TypeScript codebase from 
               version 2 (v2) to version 3 (v3). 

Example: aws-sdk-js-codemod -t v2-to-v3 example.js

To use the latest version of aws-sdk-js-codemod, please clear your npx cache and re-run.
-----------------------------------------------------------------------------------------------

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs and link to relevant comments in this thread.