release: add crates, npm, and homebrew publish pipeline

hanbu97 · hanbu97 · commit 2a8aa237956c · 2026-02-28T20:32:48.000+08:00
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -13,6 +13,7 @@ permissions:
 
 env:
   CARGO_TERM_COLOR: always
+  HOMEBREW_TAP_REPO: hanbu97/homebrew-tap
 
 jobs:
   build:
@@ -55,6 +56,8 @@ jobs:
           cp "target/${{ matrix.target }}/release/tu" "dist/${ASSET_NAME}/"
           cp README.md LICENSE "dist/${ASSET_NAME}/"
           tar -C dist -czf "dist/${ASSET_NAME}.tar.gz" "${ASSET_NAME}"
+          cp "target/${{ matrix.target }}/release/tu" "dist/${ASSET_NAME}"
+          chmod +x "dist/${ASSET_NAME}"
           rm -rf "dist/${ASSET_NAME}"
 
       - name: Package archive (Windows)
@@ -66,6 +69,7 @@ jobs:
           Copy-Item "target/${{ matrix.target }}/release/tu.exe" "dist/$assetName/"
           Copy-Item "README.md","LICENSE" "dist/$assetName/"
           Compress-Archive -Path "dist/$assetName/*" -DestinationPath "dist/$assetName.zip" -Force
+          Copy-Item "target/${{ matrix.target }}/release/tu.exe" "dist/$assetName.exe"
           Remove-Item "dist/$assetName" -Recurse -Force
 
       - name: Upload build artifact
@@ -91,7 +95,9 @@ jobs:
         run: |
           set -euxo pipefail
           cd dist
-          sha256sum *.tar.gz *.zip > SHA256SUMS.txt
+          shopt -s nullglob
+          files=( *.tar.gz *.zip tu-* tu-*.exe )
+          sha256sum "${files[@]}" > SHA256SUMS.txt
 
       - name: Upload release bundle
         uses: actions/upload-artifact@v4
@@ -117,3 +123,124 @@ jobs:
         with:
           files: dist/*
           generate_release_notes: true
+
+  publish-crates:
+    name: Publish crates.io
+    runs-on: ubuntu-latest
+    needs: checksums
+    if: startsWith(github.ref, 'refs/tags/v') && secrets.CRATES_IO_TOKEN != ''
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Verify Cargo version matches tag
+        run: |
+          set -euxo pipefail
+          tag="${GITHUB_REF_NAME#v}"
+          cargo_version=$(grep -E '^version\\s*=\\s*\"' Cargo.toml | head -n1 | sed -E 's/.*\"([^\"]+)\".*/\\1/')
+          test "$tag" = "$cargo_version"
+
+      - name: Publish crate
+        run: cargo publish --locked --token "${{ secrets.CRATES_IO_TOKEN }}"
+
+  publish-npm:
+    name: Publish npm package
+    runs-on: ubuntu-latest
+    needs: publish
+    if: startsWith(github.ref, 'refs/tags/v') && secrets.NPM_TOKEN != ''
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Verify npm package version matches tag
+        run: |
+          set -euxo pipefail
+          tag="${GITHUB_REF_NAME#v}"
+          npm_version=$(node -p "require('./npm/tu/package.json').version")
+          test "$tag" = "$npm_version"
+
+      - name: Publish npm package
+        working-directory: npm/tu
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  publish-homebrew-tap:
+    name: Publish Homebrew tap formula
+    runs-on: ubuntu-latest
+    needs: checksums
+    if: startsWith(github.ref, 'refs/tags/v') && secrets.HOMEBREW_TAP_PAT != ''
+    steps:
+      - name: Download release bundle
+        uses: actions/download-artifact@v4
+        with:
+          name: tu-release-bundle
+          path: dist
+
+      - name: Generate Formula
+        run: |
+          set -euxo pipefail
+          version="${GITHUB_REF_NAME#v}"
+          linux_sha=$(sha256sum "dist/tu-${GITHUB_REF_NAME}-x86_64-unknown-linux-gnu.tar.gz" | awk '{print $1}')
+          mac_arm_sha=$(sha256sum "dist/tu-${GITHUB_REF_NAME}-aarch64-apple-darwin.tar.gz" | awk '{print $1}')
+          mac_x64_sha=$(sha256sum "dist/tu-${GITHUB_REF_NAME}-x86_64-apple-darwin.tar.gz" | awk '{print $1}')
+
+          mkdir -p out/Formula
+          cat > out/Formula/tu.rb <<RUBY
+          class Tu < Formula
+            desc "Blazing-fast Rust token usage tracker for Codex and Claude Code"
+            homepage "https://github.com/hanbu97/tokenusage"
+            license "MIT"
+            version "${version}"
+
+            on_macos do
+              if Hardware::CPU.arm?
+                url "https://github.com/hanbu97/tokenusage/releases/download/v${version}/tu-v${version}-aarch64-apple-darwin.tar.gz"
+                sha256 "${mac_arm_sha}"
+              else
+                url "https://github.com/hanbu97/tokenusage/releases/download/v${version}/tu-v${version}-x86_64-apple-darwin.tar.gz"
+                sha256 "${mac_x64_sha}"
+              end
+            end
+
+            on_linux do
+              url "https://github.com/hanbu97/tokenusage/releases/download/v${version}/tu-v${version}-x86_64-unknown-linux-gnu.tar.gz"
+              sha256 "${linux_sha}"
+            end
+
+            def install
+              bin.install "tu"
+              prefix.install "README.md", "LICENSE"
+            end
+
+            test do
+              assert_match "tokenusage", shell_output("#{bin}/tu --version")
+            end
+          end
+          RUBY
+
+      - name: Update tap repository
+        run: |
+          set -euxo pipefail
+          git clone "https://x-access-token:${{ secrets.HOMEBREW_TAP_PAT }}@github.com/${HOMEBREW_TAP_REPO}.git" tap
+          mkdir -p tap/Formula
+          cp out/Formula/tu.rb tap/Formula/tu.rb
+          cd tap
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Formula/tu.rb
+          if git diff --cached --quiet; then
+            echo "No formula changes."
+            exit 0
+          fi
+          git commit -m "chore: update tu formula for ${GITHUB_REF_NAME}"
+          git push origin HEAD:main
diff --git a/.gitignore b/.gitignore
@@ -1 +1,3 @@
 /target
+npm/tu/*.tgz
+npm/tu/vendor/
diff --git a/README.md b/README.md
@@ -36,16 +36,29 @@ This project is built for people searching for:
 
 ## Install
 
-### From source
+### cargo (crates.io)
 
 ```bash
-cargo install --path . --bin tu --force
+cargo install tokenusage --bin tu
 ```
 
-### From crates.io (after publish)
+### Homebrew
 
 ```bash
-cargo install tokenusage --bin tu
+brew tap hanbu97/tap
+brew install tu
+```
+
+### npm
+
+```bash
+npm install -g @hanbu97/tokenusage
+```
+
+### From source
+
+```bash
+cargo install --path . --bin tu --force
 ```
 
 ## Quick Start
@@ -234,14 +247,31 @@ cargo check
 
 ## Release (Maintainers)
 
-Tag-based release is enabled in GitHub Actions.
+Tag-based release is enabled in GitHub Actions (`.github/workflows/release.yml`).
+
+On tag push (`vX.Y.Z`), the pipeline:
+- builds and uploads release assets (Linux/macOS/Windows)
+- publishes GitHub Release
+- optionally publishes to crates.io / npm / Homebrew tap (if secrets are configured)
+
+Required repository secrets for full multi-channel publish:
+- `CRATES_IO_TOKEN`
+- `NPM_TOKEN`
+- `HOMEBREW_TAP_PAT`
+
+If a secret is missing, the corresponding publish job is automatically skipped.
+
+Homebrew tap target repo defaults to:
+- `hanbu97/homebrew-tap` (tap name: `hanbu97/tap`)
 
 ```bash
 git tag v0.1.0
 git push origin v0.1.0
 ```
 
-This will build multi-platform binaries, generate `SHA256SUMS.txt`, and publish assets to GitHub Releases.
+Version sync requirement before tagging:
+- `Cargo.toml` `package.version` must equal tag without `v`
+- `npm/tu/package.json` `version` must equal tag without `v`
 
 ## License
 
diff --git a/npm/tu/LICENSE b/npm/tu/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tokenusage contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/npm/tu/README.md b/npm/tu/README.md
@@ -0,0 +1,15 @@
+# @hanbu97/tokenusage
+
+NPM distribution for [`tokenusage`](https://github.com/hanbu97/tokenusage).
+
+## Install
+
+```bash
+npm i -g @hanbu97/tokenusage
+```
+
+## Usage
+
+```bash
+tu --help
+```
diff --git a/npm/tu/bin/tu.js b/npm/tu/bin/tu.js
@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const isWindows = process.platform === 'win32';
+const binName = isWindows ? 'tu.exe' : 'tu';
+const binPath = path.join(__dirname, '..', 'vendor', binName);
+
+if (!fs.existsSync(binPath)) {
+  console.error('[tokenusage] Native binary is missing.');
+  console.error('[tokenusage] Try reinstalling: npm i -g @hanbu97/tokenusage');
+  process.exit(1);
+}
+
+const child = spawnSync(binPath, process.argv.slice(2), {
+  stdio: 'inherit',
+});
+
+if (child.error) {
+  console.error(`[tokenusage] Failed to launch ${binName}:`, child.error.message);
+  process.exit(1);
+}
+
+process.exit(child.status ?? 1);
diff --git a/npm/tu/package.json b/npm/tu/package.json
@@ -0,0 +1,42 @@
+{
+  "name": "@hanbu97/tokenusage",
+  "version": "0.1.0",
+  "description": "Blazing-fast Rust token usage tracker for Codex and Claude Code.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hanbu97/tokenusage.git"
+  },
+  "homepage": "https://github.com/hanbu97/tokenusage#readme",
+  "bugs": {
+    "url": "https://github.com/hanbu97/tokenusage/issues"
+  },
+  "bin": {
+    "tu": "bin/tu.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "vendor",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "keywords": [
+    "codex",
+    "claude-code",
+    "token-usage",
+    "cli",
+    "rust"
+  ]
+}
diff --git a/npm/tu/scripts/postinstall.js b/npm/tu/scripts/postinstall.js

Original file line number	Diff line number	Diff line change
`@@ -1 +1,3 @@`
`1`	`1`	`/target`
	`2`	`+npm/tu/*.tgz`
	`3`	`+npm/tu/vendor/`