chore(npm): keep package name 'cxusage'; update README and AGENTS accordingly

Author: Effet

.github/workflows/release-npm.yml

@@ -14,12 +14,26 @@ jobs:
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'
+          always-auth: true
       - name: Install
         run: npm ci || npm i
       - name: Build
         run: npm run build
+      - name: Align package.json version with tag
+        id: version
+        run: |
+          TAG_REF="${GITHUB_REF#refs/tags/}"
+          TAG_NAME="${TAG_REF#v}"
+          echo "Tag: ${TAG_REF} -> version: ${TAG_NAME}"
+          npm version "${TAG_NAME}" --no-git-tag-version
+          echo "version=${TAG_NAME}" >> $GITHUB_OUTPUT
+      - name: Choose dist-tag
+        id: dist
+        run: |
+          VER="${{ steps.version.outputs.version }}"
+          if [[ "$VER" == *-* ]]; then echo "tag=next" >> $GITHUB_OUTPUT; else echo "tag=latest" >> $GITHUB_OUTPUT; fi
+          echo "dist-tag=$(cat $GITHUB_OUTPUT)"
       - name: Publish
-        run: npm publish --access public
+        run: npm publish --access public --tag ${{ steps.dist.outputs.tag }}
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-

AGENTS.md

@@ -34,6 +34,7 @@ Validation checklist for changes that touch runtime behavior:
 
 - `package.json` contains `bin` mapping to `dist/cli.js` and `prepublishOnly` builds the package.
 - Do not rely on `prepare` to build; we commit `dist/` and build in release workflow to support `npx github:...` usage.
+- NPM package name: `cxusage`. The CLI installs the `cxusage` bin.
 - NPM publish is automated on tags matching `v*.*.*` via GitHub Actions; requires `NPM_TOKEN` secret.
 
 ## Code style
@@ -54,4 +55,3 @@ Validation checklist for changes that touch runtime behavior:
 - Outline a brief plan: goals, approach, and expected changes.
 - Keep commits scoped and messages clear.
 - If adding dependencies, justify the choice and impact.
-

README.md

@@ -12,8 +12,8 @@ Analyze Claude Code daily usage from Codex session logs. Similar to `ccusage`, t
 - After publish to npm: `npx cxusage --help`
 - From GitHub (before publish): `npx github:Effet/cxusage -- --help`
 - Typical commands:
-  - `cxusage daily --from 2025-01-01 --to 2025-01-31 --md`
-  - `cxusage daily --by model --json`
+  - `npx cxusage daily --from 2025-01-01 --to 2025-01-31 --md`
+  - `npx cxusage daily --by model --json`
 
 ## Usage
 
@@ -63,4 +63,6 @@ This package exposes only a CLI. If you need a library API, please open an issue
 
 - CI runs on pushes/PRs to verify install and build.
 - Stable release: create a Git tag like `v0.1.0` to publish to npm as `latest`.
+  - The workflow automatically sets `package.json` version from the Git tag (stripping the leading `v`).
+  - Pre-release tags (containing a hyphen, e.g. `v0.2.0-rc.1`) publish with the `next` dist-tag.
 - The release workflow requires a repository secret `NPM_TOKEN` with publish permissions.