@yabasha/gex 1.3.1 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +11 -5
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -51,8 +51,8 @@ Common options:
51
51
  - -o, --out-file <path>
52
52
  - --full-tree Include the full npm ls JSON under `tree` (default uses depth=0)
53
53
  - --omit-dev Local only; exclude devDependencies
54
- - -c, --check-outdated Print a table of outdated packages (skips console report output unless `-o` is set)
55
- - -u, --update-outdated [pkg1 pkg2 ...] Update outdated packages (omit names to update everything). Node CLI shells out to `npm update`, Bun CLI runs `bun update`/`bun update --global`.
54
+ - -c, --check-outdated Print a table of outdated packages (shows a lightweight spinner while checking; skips console report output unless `-o` is set so you can write the report to file instead)
55
+ - -u, --update-outdated [pkg1 pkg2 ...] Update outdated packages (omit names to update everything). Node CLI shells out to `npm update`; Bun CLI mirrors `bun update` for locals and reinstalls globals via `bun add -g pkg@latest`.
56
56
 
57
57
  Examples:
58
58
 
@@ -88,13 +88,13 @@ gex global | jq '.global_packages' # pipe output to jq for processing
88
88
 
89
89
  # Check outdated packages / update them (Node runtime)
90
90
  gex local --check-outdated # show outdated local deps as a table
91
- gex global --check-outdated # show outdated globals
91
+ gex global -c # short flag works too
92
92
  gex local --update-outdated # update every outdated local dependency
93
- gex local --update-outdated axios react # update specific packages
93
+ gex local -u axios react # update specific packages
94
94
 
95
95
  # Bun runtime uses the same flags
96
96
  gex-bun local --check-outdated
97
- gex-bun global --update-outdated # updates global Bun installs via `bun update`
97
+ gex-bun global --update-outdated # updates global Bun installs via `bun update`/`bun add -g`
98
98
  ```
99
99
 
100
100
  > **Note**: Starting from v0.4.0, GEX outputs to console by default instead of creating files automatically. Use the `-o/--out-file` flag to write to a file.
@@ -137,6 +137,12 @@ Example (truncated):
137
137
  }
138
138
  ```
139
139
 
140
+ ## Outdated workflow
141
+
142
+ - Use `-c/--check-outdated` to produce a focused table of outdated packages. GEX shows a lightweight spinner while it queries npm, then prints `Name`, `Current`, `Wanted`, `Latest`, and `Type`. Combine the flag with `-o report.json` if you still need the report file.
143
+ - Use `-u/--update-outdated` to upgrade packages. Without arguments every outdated package is updated; include package names to only bump a subset (e.g., `-u axios react`). Node CLI shells out to `npm update`, whereas Bun CLI runs `bun update` for local projects and `bun add -g pkg@latest` for globals.
144
+ - After updating you can immediately rerun `-c` to verify everything is current—reports generated with `-o` will now include the updated versions.
145
+
140
146
  ## Production usage
141
147
 
142
148
  - Deterministic output: packages are sorted by name; default uses depth=0 for fast, stable runs.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yabasha/gex",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "private": false,
5
5
  "description": "A CLI tool for auditing and documenting your Node.js package environment, generating comprehensive reports of global and local dependencies.",
6
6
  "type": "module",