burnbar 0.0.0-dev.37.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lahiru S Liyanage
+
+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.

package/README.md

@@ -0,0 +1,245 @@
+<div align="center">
+
+<img src="assets/icon.png" alt="BurnBar icon" width="96">
+
+# BurnBar
+
+[![Build](https://github.com/nooblk-98/burnbar/actions/workflows/build.yml/badge.svg)](https://github.com/nooblk-98/burnbar/actions/workflows/build.yml)
+[![Release](https://img.shields.io/github/v/release/nooblk-98/burnbar?include_prereleases&label=release)](https://github.com/nooblk-98/burnbar/releases)
+[![Go](https://img.shields.io/github/go-mod/go-version/nooblk-98/burnbar)](go.mod)
+[![Platform](https://img.shields.io/badge/platform-Windows%2010%20%7C%2011-0078D4)](#installation)
+[![License](https://img.shields.io/github/license/nooblk-98/burnbar)](LICENSE)
+
+**Claude and Codex usage meter for the Windows taskbar.**<br>
+See how fast you're burning through your plan limits without leaving what you're doing.
+
+[Features](#features) • [See it in action](#see-it-in-action) • [Installation](#installation) • [Build from source](#build-from-source)
+
+<img src="assets/social-preview.png" alt="BurnBar, Claude and Codex on your Windows taskbar, with quotas, history, and alerts" width="848">
+
+</div>
+
+Claude and Codex have session and longer-term plan limits. BurnBar keeps both providers on your
+taskbar, warns you before you run out, and shows whether you're using them faster than the time
+window allows. Use both together, or select one from **Usage providers** in the right-click menu.
+Codex window lengths come from your account rather than assuming every plan uses the same limits.
+
+> [!NOTE]
+> BurnBar is an unofficial community project, not affiliated with or endorsed by Anthropic or OpenAI.
+> "Claude" and "Codex" belong to their respective owners.
+
+## Features
+
+- **Claude + Codex**: one compact meter rotates between providers every 8 seconds with a downward
+  flip animation. The provider name stays visible above its two quota bars. Rotation pauses on
+  hover and while details are open, and respects Windows' animation setting.
+  Select Claude only or Codex only to keep one provider visible. Bars turn red at 90%.
+- **Pace marker**: a tick on each bar shows how much of the window's time has passed. A bar past its
+  tick means you'll hit the limit before it resets.
+- **Stays out of the way**: finds free space on the taskbar so it never covers app icons, follows the
+  light/dark theme and display scaling, and hides during fullscreen apps and games.
+  The meter narrows when taskbar buttons need more room. If no safe gap fits, it hides
+  until space opens; the tray icon and details remain available. It never floats over desktop
+  content. Vertical or too-short taskbars also use the tray icon. Search, Start and ordinary
+  window clicks keep it visible when space is available.
+- **Details panel**: separate provider panels, reported quota windows, reset times, and independent
+  24-hour and 7-day history charts. Claude also shows this week's usage by product when available.
+- **Alerts**: Windows notifications at 80% and 95%, and when a limit you'd been close to resets.
+- **Fresh numbers**: refreshes on a schedule, within a minute of Claude Code or Codex activity, and right after
+  a limit resets, backing off automatically if the API rate-limits.
+- **Multi-monitor**: a meter on every taskbar, plus a tray icon with tooltip and menu.
+- **Lightweight**: a single executable with no installer. Codex usage uses your existing Codex CLI.
+- **Start with Windows**: enabled on first launch for new users; turn it off from the
+  right-click menu at any time. Existing startup preferences are preserved.
+- **About**: right-click the meter or tray icon for the app version, developer credits,
+  and a link to this repository.
+
+## See it in action
+
+<div align="center">
+<img src="docs/images/burnbar-demo.gif" alt="BurnBar on Windows, showing the rotating taskbar meter and Claude and Codex usage details" width="848">
+<br>
+<sub>BurnBar in action: Claude and Codex usage on the taskbar, with details a click away.</sub>
+</div>
+
+## Installation
+
+You need Windows 10 or 11 and a signed-in provider:
+
+- **Claude:** [Claude Code](https://claude.com/claude-code) signed in with a Claude subscription.
+- **Codex:** [Codex CLI](https://developers.openai.com/codex/cli/) signed in with **ChatGPT**
+  (`codex login`). API-key-only accounts do not provide these subscription usage limits.
+  BurnBar also detects the CLI bundled with the Windows Codex desktop app when available.
+
+Both providers rotate through the meter by default. A missing login affects only that provider. Select
+**Usage providers** from the right-click menu to hide a provider you don't use.
+
+### Install or update with npx
+
+Requires Windows, [Node.js 22+](https://nodejs.org/) (includes npm/npx), and
+Windows PowerShell 5.1. BurnBar itself does not need Node.js after installation.
+
+Install or update using these npm channels (the stable `latest` tag is created
+by the first stable release after this workflow reaches main):
+
+```powershell
+# Latest stable release (same command for first install and updates)
+npx --yes burnbar@latest install
+
+# Latest development build (may contain bugs)
+npx --yes burnbar@development install
+
+# Switch back to stable
+npx --yes burnbar@latest update --channel stable
+```
+
+`latest` and `development` are **npm installer channels**. The installer selects
+the matching **GitHub binary channel** by default; `--channel` overrides it.
+The installer package version is not a pin to a particular executable version:
+each invocation checks GitHub for the latest published build of that channel.
+Updates are explicit, not an always-running automatic updater.
+
+**Before the first stable npm publish**, use the development installer to install
+the stable executable:
+
+```powershell
+npx --yes burnbar@development install --channel stable
+```
+
+Alternatively, use the GitHub-backed package (also
+requires Git). These commands do not require an npm account or npm publication:
+
+```powershell
+npx --yes github:nooblk-98/burnbar#development install --channel stable
+npx --yes github:nooblk-98/burnbar#development install --channel development
+```
+
+Both channels use `%LOCALAPPDATA%\Programs\BurnBar` and preserve existing settings,
+history and startup preferences when switching. The CLI delegates to its bundled
+PowerShell installer, verifies SHA-256 before replacing anything, and creates a
+Start menu shortcut. A development push publishes an immutable prerelease build;
+stable installs never select those prereleases.
+
+```powershell
+# Optional flags work with either package source
+npx --yes burnbar@latest update --install-dir 'D:\Apps\BurnBar' --no-start
+npx --yes burnbar@development install --dry-run
+```
+
+`--dry-run` reads release metadata only: no binary download, file replacement,
+process shutdown or launch. See [release setup](docs/RELEASING.md) for npm publishing.
+
+### Install or update with PowerShell (no Node.js required)
+
+
+Run this in a regular PowerShell window; administrator access is not needed:
+
+```powershell
+& ([scriptblock]::Create((irm https://raw.githubusercontent.com/nooblk-98/burnbar/main/install.ps1)))
+```
+
+The same command installs or updates the **latest stable release** in
+`%LOCALAPPDATA%\Programs\BurnBar`, verifies its SHA-256 checksum, adds a Start menu
+shortcut, and launches BurnBar. Existing settings and history are kept. A running
+BurnBar instance in your session is closed after the download is verified.
+
+You can [review the installer](install.ps1) before running it. To choose a folder
+or install without launching:
+
+```powershell
+$installer = irm https://raw.githubusercontent.com/nooblk-98/burnbar/main/install.ps1
+& ([scriptblock]::Create($installer)) -InstallDir 'D:\Apps\BurnBar' -NoStart
+```
+
+For a manual install, download `burnbar.exe` from the
+[releases page](https://github.com/nooblk-98/burnbar/releases), put it anywhere,
+and run it.
+
+On its first normal launch, BurnBar enables **Start with Windows** for a new profile.
+You can disable it from the right-click menu. Demo and diagnostic modes do not enable it.
+
+> [!NOTE]
+> BurnBar is distributed **unsigned**. Windows Smart App Control may block it,
+> and SmartScreen may show *Windows protected your PC*.
+
+### If Smart App Control blocks BurnBar (Windows 11)
+
+> [!WARNING]
+> Turning off Smart App Control reduces protection for your whole PC. Recent Windows
+> updates support turning it back on, but availability depends on your device and
+> configuration. If Windows warns that restoring it requires a reset or reinstall,
+> do not proceed expecting a temporary change.
+
+1. Install the latest Windows updates before changing this setting.
+2. Open **Windows Security > App & browser control > Smart App Control settings**.
+3. If you trust the download and choose to proceed, select **Off** before running
+   BurnBar. Read the confirmation carefully.
+4. Download `burnbar.exe` from this repository's releases, place it in your preferred
+   folder, and run it. BurnBar is portable and has no installer.
+5. Afterwards, return to **Smart App Control settings** and select **On**, if
+   available. Restart if Windows asks, and confirm protection is on.
+
+Turning protection back on may block BurnBar again. Running it once does not create
+an exception for the app. See [Microsoft's Smart App Control FAQ](https://support.microsoft.com/en-us/windows/security/threat-malware-protection/smart-app-control-frequently-asked-questions)
+for current requirements and limitations.
+
+## Build from source
+
+You need [Go 1.26+](https://go.dev/dl/) on Windows.
+
+```powershell
+git clone https://github.com/nooblk-98/burnbar.git
+cd burnbar
+.\build.ps1
+.\bin\burnbar.exe
+```
+
+`build.ps1` runs vet and any locally available tests, then builds `bin\burnbar.exe`.
+Add `-Resources` to regenerate the icon, manifest and version info, or `-SkipTests`
+to skip local tests. Test sources are excluded from Git.
+
+The executable also accepts a few flags for development:
+
+| Flag | Description |
+|---|---|
+| `-demo` | Show sample numbers and history without calling the API |
+| `-providers both` | Show Claude and Codex; also accepts `claude` or `codex`. Defaults to the saved menu setting. |
+| `-taskbar-layout` | Print measured taskbar spans and the compact meter's available slot, then exit. Useful for diagnosing placement. |
+| `-snapshot <dir>` | Render PNG previews and the provider-rotation GIF in both themes, then exit. Combine with `-demo -providers both`. |
+| `-once` | Print usage summaries for the selected providers, then exit. Needs a console build: `go build -o bin\burnbar-cli.exe ./cmd/burnbar` |
+
+> [!WARNING]
+> Local builds and release builds are unsigned, so Windows **Smart App Control** may block them.
+> See [Releasing BurnBar](docs/RELEASING.md) for the release process.
+
+<details>
+<summary><strong>Project layout</strong></summary>
+
+```
+cmd/burnbar/          entry point, flags, embedded icon and manifest
+internal/app/         Windows UI: taskbar meters, tray icon, details panel, menu, Win32 and UI Automation
+internal/usage/       Claude usage client and Codex app-server account client
+internal/render/      drawing the meter, details panel, charts and tray icon
+internal/layout/      choosing a free spot on the taskbar
+internal/config/      settings and alert state
+internal/history/     usage history for the charts
+tools/genres/         icon and Windows resource generator
+assets/               app icon
+docs/                 screenshots and release guide
+.github/workflows/    CI, GitHub releases and optional winget publishing
+```
+
+</details>
+
+## Contributing
+
+Contributors are welcome! Bug fixes, documentation improvements, and new AI tool
+integrations are all appreciated. Feel free to open a pull request.
+
+See the [contribution guide](CONTRIBUTING.md) for setup and checks, the
+[roadmap](ROADMAP.md) for upcoming work, and [privacy details](PRIVACY.md) for data
+access and storage.
+
+Support for more AI tools is coming soon. To request a specific tool or suggest a
+feature, [open an issue](https://github.com/nooblk-98/burnbar/issues/new/choose) and tell us
+what you would like to see.

package/install.ps1

@@ -0,0 +1,206 @@
+#requires -Version 5.1
+<#
+.SYNOPSIS
+Installs or updates a stable or development BurnBar release for the current user.
+.EXAMPLE
+& .\install.ps1
+.EXAMPLE
+& .\install.ps1 -InstallDir 'D:\Apps\BurnBar' -NoStart
+#>
+[CmdletBinding(SupportsShouldProcess = $true)]
+param(
+    [string]$InstallDir = (Join-Path $env:LOCALAPPDATA 'Programs\BurnBar'),
+    [switch]$NoStart,
+    [ValidateSet('stable', 'development')]
+    [string]$Channel = 'stable'
+)
+
+$ErrorActionPreference = 'Stop'
+if ([Environment]::OSVersion.Platform -ne [PlatformID]::Win32NT) {
+    throw 'BurnBar requires Windows.'
+}
+if (-not [Environment]::Is64BitOperatingSystem) {
+    throw 'The BurnBar release requires 64-bit Windows.'
+}
+
+$installPath = [IO.Path]::GetFullPath([Environment]::ExpandEnvironmentVariables($InstallDir))
+$targetExe = Join-Path $installPath 'burnbar.exe'
+$headers = @{ 'User-Agent' = 'BurnBar-Installer'; Accept = 'application/vnd.github+json' }
+$previousTls = [Net.ServicePointManager]::SecurityProtocol
+$stagePath = $null
+$preserveBackup = $false
+$stoppedPaths = @()
+$installComplete = $false
+
+function Get-BurnBarProcesses {
+    param([string]$Target, [bool]$TargetOnly)
+    $session = [Diagnostics.Process]::GetCurrentProcess().SessionId
+    foreach ($candidate in @(Get-Process -Name 'burnbar*' -ErrorAction SilentlyContinue)) {
+        try {
+            if ($candidate.SessionId -ne $session -or -not $candidate.Path) { continue }
+            $candidatePath = [IO.Path]::GetFullPath($candidate.Path)
+            if ($candidatePath -eq $Target) {
+                $candidate
+            } elseif (-not $TargetOnly) {
+                $info = [Diagnostics.FileVersionInfo]::GetVersionInfo($candidatePath)
+                if ($info.ProductName -eq 'BurnBar' -and $info.OriginalFilename -eq 'burnbar.exe') {
+                    $candidate
+                }
+            }
+        } catch {
+            # Never stop an inaccessible or unverified process based only on its name.
+            continue
+        }
+    }
+}
+
+try {
+    [Net.ServicePointManager]::SecurityProtocol = $previousTls -bor [Net.SecurityProtocolType]::Tls12
+    Write-Host "Checking the latest BurnBar $Channel release..."
+    if ($Channel -eq 'stable') {
+        $release = Invoke-RestMethod -Uri 'https://api.github.com/repos/nooblk-98/burnbar/releases/latest' -Headers $headers -TimeoutSec 30
+        if ($release.draft -or $release.prerelease -or -not $release.tag_name) {
+            throw 'GitHub did not return a published stable release.'
+        }
+    } else {
+        # Each development build has immutable assets. Never update two assets on
+        # a rolling release, where concurrent clients could fetch a mixed pair.
+        $release = $null
+        for ($page = 1; $page -le 20; $page++) {
+            $releases = @((Invoke-RestMethod -Uri "https://api.github.com/repos/nooblk-98/burnbar/releases?per_page=100&page=$page" -Headers $headers -TimeoutSec 30))
+            $release = $releases | Where-Object { -not $_.draft -and $_.prerelease -and $_.tag_name -match '^dev-[0-9]+-[0-9]+$' } | Select-Object -First 1
+            if ($release -or $releases.Count -lt 100) { break }
+        }
+        if (-not $release) { throw 'No published development build was found. Try the stable channel or wait for the development workflow.' }
+        Write-Warning 'Installing an unreleased development build. Switch to --channel stable to return to a stable release.'
+    }
+    $exeAssets = @($release.assets | Where-Object { $_.name -ceq 'burnbar.exe' })
+    $hashAssets = @($release.assets | Where-Object { $_.name -ceq 'burnbar.exe.sha256' })
+    if ($exeAssets.Count -ne 1 -or $hashAssets.Count -ne 1) {
+        throw "Release $($release.tag_name) must contain burnbar.exe and burnbar.exe.sha256."
+    }
+    foreach ($asset in @($exeAssets[0], $hashAssets[0])) {
+        $assetUri = [Uri]$asset.browser_download_url
+        $expectedAssetPath = '/nooblk-98/burnbar/releases/download/' + [Uri]::EscapeDataString($release.tag_name) + '/' + $asset.name
+        if ($assetUri.Scheme -ne 'https' -or $assetUri.Host -ne 'github.com' -or
+            $assetUri.AbsolutePath -cne $expectedAssetPath -or $assetUri.Query -or $assetUri.Fragment) {
+            throw 'The release contains an unexpected download URL.'
+        }
+    }
+    if (-not $PSCmdlet.ShouldProcess($targetExe, "Install or update BurnBar $($release.tag_name)")) {
+        return
+    }
+
+    [IO.Directory]::CreateDirectory($installPath) | Out-Null
+    $stagePath = Join-Path $installPath ('.burnbar-update-' + [Guid]::NewGuid().ToString('N'))
+    [IO.Directory]::CreateDirectory($stagePath) | Out-Null
+    $downloadExe = Join-Path $stagePath 'burnbar.exe'
+    $downloadHash = Join-Path $stagePath 'burnbar.exe.sha256'
+    $backupExe = Join-Path $stagePath 'burnbar.previous.exe'
+    Write-Host "Downloading BurnBar $($release.tag_name)..."
+    Invoke-WebRequest -UseBasicParsing -Uri $hashAssets[0].browser_download_url -Headers $headers -OutFile $downloadHash -TimeoutSec 60 | Out-Null
+    Invoke-WebRequest -UseBasicParsing -Uri $exeAssets[0].browser_download_url -Headers $headers -OutFile $downloadExe -TimeoutSec 180 | Out-Null
+    $hashText = (Get-Content -LiteralPath $downloadHash -Raw).Trim()
+    if ($hashText -notmatch '\A([0-9a-fA-F]{64})[ \t]+\*?burnbar\.exe\z') {
+        throw 'The release checksum file has an unexpected format.'
+    }
+    $expectedHash = $Matches[1].ToLowerInvariant()
+    $actualHash = (Get-FileHash -LiteralPath $downloadExe -Algorithm SHA256).Hash.ToLowerInvariant()
+    if ($actualHash -ne $expectedHash) {
+        throw 'SHA-256 verification failed. The existing installation was not changed.'
+    }
+    $digest = $exeAssets[0].digest
+    if ($digest -and $digest -ne ('sha256:' + $actualHash)) {
+        throw 'The download does not match the release asset digest. Installation was stopped.'
+    }
+
+    $sameFile = (Test-Path -LiteralPath $targetExe -PathType Leaf) -and
+        ((Get-FileHash -LiteralPath $targetExe -Algorithm SHA256).Hash.ToLowerInvariant() -eq $actualHash)
+    $targetRunning = $false
+    foreach ($running in @(Get-BurnBarProcesses -Target $targetExe -TargetOnly $NoStart.IsPresent)) {
+        if ($running.HasExited) { continue }
+        if ($sameFile -and $running.Path -eq $targetExe) {
+            $targetRunning = $true
+            continue
+        }
+        $runningPath = $running.Path
+        Write-Host 'Closing the running BurnBar instance...'
+        $closed = $running.CloseMainWindow() -and $running.WaitForExit(3000)
+        if (-not $closed) {
+            Stop-Process -Id $running.Id -Force -ErrorAction Stop
+            if (-not $running.WaitForExit(5000)) { throw 'BurnBar did not exit; the update was stopped.' }
+        }
+        $stoppedPaths += $runningPath
+    }
+    if (-not $sameFile) {
+        if (Test-Path -LiteralPath $targetExe -PathType Leaf) {
+            [IO.File]::Replace($downloadExe, $targetExe, $backupExe)
+        } else {
+            [IO.File]::Move($downloadExe, $targetExe)
+        }
+    }
+    $installComplete = $true
+
+    try {
+        $programs = Join-Path $env:APPDATA 'Microsoft\Windows\Start Menu\Programs'
+        [IO.Directory]::CreateDirectory($programs) | Out-Null
+        $shell = New-Object -ComObject WScript.Shell
+        $shortcut = $shell.CreateShortcut((Join-Path $programs 'BurnBar.lnk'))
+        $shortcut.TargetPath = $targetExe
+        $shortcut.WorkingDirectory = $installPath
+        $shortcut.IconLocation = "$targetExe,0"
+        $shortcut.Description = 'Claude and Codex usage monitor for the Windows taskbar'
+        $shortcut.Save()
+    } catch {
+        Write-Warning "BurnBar is installed, but its Start menu shortcut could not be created: $($_.Exception.Message)"
+    }
+    if (-not $NoStart -and -not $targetRunning) {
+        try {
+            $started = Start-Process -FilePath $targetExe -WorkingDirectory $installPath -WindowStyle Hidden -PassThru
+            Start-Sleep -Milliseconds 1000
+            if ($started.HasExited) {
+                Write-Warning 'BurnBar exited after launch. Another copy may be running; close it and launch the installed executable.'
+            }
+        } catch {
+            Write-Warning "BurnBar is installed, but Windows could not launch it: $($_.Exception.Message)"
+            Write-Warning 'See the README for unsigned-app and Smart App Control guidance.'
+        }
+    }
+    if ($sameFile) {
+        Write-Host "BurnBar $($release.tag_name) is already up to date."
+    } else {
+        Write-Host "Installed BurnBar $($release.tag_name)."
+    }
+    Write-Host "Location: $targetExe"
+} catch {
+    $installError = $_
+    if ($stagePath -and (Test-Path -LiteralPath (Join-Path $stagePath 'burnbar.previous.exe'))) {
+        try {
+            [IO.File]::Copy((Join-Path $stagePath 'burnbar.previous.exe'), $targetExe, $true)
+        } catch {
+            $preserveBackup = $true
+            Write-Warning "The previous executable is preserved at $stagePath\burnbar.previous.exe."
+        }
+    }
+    if (-not $NoStart -and -not $installComplete) {
+        foreach ($oldPath in @($stoppedPaths | Select-Object -Unique)) {
+            try { Start-Process -FilePath $oldPath -WindowStyle Hidden | Out-Null } catch {
+                Write-Warning "Could not restart the previous BurnBar instance at $oldPath."
+            }
+        }
+    }
+    throw $installError
+} finally {
+    [Net.ServicePointManager]::SecurityProtocol = $previousTls
+    if ($stagePath) {
+        # Remove only our explicitly named files, then the empty staging directory.
+        # No recursive deletion or paths outside the unique staging directory.
+        foreach ($name in @('burnbar.exe', 'burnbar.exe.sha256')) {
+            Remove-Item -LiteralPath (Join-Path $stagePath $name) -Force -ErrorAction SilentlyContinue
+        }
+        if (-not $preserveBackup) {
+            Remove-Item -LiteralPath (Join-Path $stagePath 'burnbar.previous.exe') -Force -ErrorAction SilentlyContinue
+            try { [IO.Directory]::Delete($stagePath) } catch { }
+        }
+    }
+}

package/npm/bin/burnbar.cjs

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+'use strict';
+
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const pkg = require('../../package.json');
+
+const help = `BurnBar installer ${pkg.version}
+
+Usage: burnbar [install|update] [options]
+  --channel stable|development  Release channel (default: matches installer package)
+  --install-dir <directory>     Override %LOCALAPPDATA%\\Programs\\BurnBar
+  --no-start                    Install without launching BurnBar
+  --dry-run                     Check release metadata without modifying the installation
+  --help                        Show this help
+  --version                     Show the installer package version
+
+Install and update use the same verified replacement process. Switching channels
+replaces the executable but preserves your settings and history.
+Requires Windows x64 (or x64 emulation), Node.js 22+, and Windows PowerShell 5.1.
+`;
+
+function parseArgs(args) {
+  const options = { channel: pkg.version.includes('-dev.') ? 'development' : 'stable' };
+  const seen = new Set();
+  if (args[0] === 'install' || args[0] === 'update') args = args.slice(1);
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (seen.has(arg)) throw new Error(`Duplicate option: ${arg}`);
+    seen.add(arg);
+    switch (arg) {
+      case '--channel':
+      case '--install-dir': {
+        const value = args[++i];
+        if (!value || value.startsWith('-')) throw new Error(`${arg} needs a value`);
+        if (arg === '--channel') {
+          if (!['stable', 'development'].includes(value)) throw new Error('Channel must be stable or development');
+          options.channel = value;
+        } else {
+          options.installDir = path.resolve(value);
+        }
+        break;
+      }
+      case '--no-start': options.noStart = true; break;
+      case '--dry-run': options.dryRun = true; break;
+      case '--help': options.help = true; break;
+      case '--version': options.version = true; break;
+      default: throw new Error(`Unknown argument: ${arg}. Use --help for usage.`);
+    }
+  }
+  return options;
+}
+
+function invocation(options, env = process.env) {
+  if (!env.SystemRoot || !path.win32.isAbsolute(env.SystemRoot)) {
+    throw new Error('Cannot locate Windows PowerShell: SystemRoot is missing or invalid');
+  }
+  // Use the system executable and a bundled script. Never fetch/execute a remote
+  // script or interpolate user input into a PowerShell command string.
+  const executable = path.win32.join(env.SystemRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+  const args = ['-NoLogo', '-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass',
+    '-File', path.resolve(__dirname, '../../install.ps1'), '-Channel', options.channel];
+  if (options.installDir) args.push('-InstallDir', options.installDir);
+  if (options.noStart) args.push('-NoStart');
+  if (options.dryRun) args.push('-WhatIf');
+  return { executable, args };
+}
+
+function main(args = process.argv.slice(2), runtime = { platform: process.platform, env: process.env, spawnSync }) {
+  try {
+    const options = parseArgs(args);
+    if (options.help) { console.log(help); return 0; }
+    if (options.version) { console.log(pkg.version); return 0; }
+    if (runtime.platform !== 'win32') throw new Error('BurnBar requires Windows. No files were installed.');
+    const { executable, args: psArgs } = invocation(options, runtime.env);
+    // PowerShell 7 can pass its incompatible module search path to Windows
+    // PowerShell 5.1 (e.g. when npx is launched from pwsh). Let 5.1 construct
+    // its own module path so standard cmdlets such as Get-FileHash resolve.
+    const childEnv = { ...runtime.env };
+    for (const key of Object.keys(childEnv)) {
+      if (key.toLowerCase() === 'psmodulepath') delete childEnv[key];
+    }
+    const result = runtime.spawnSync(executable, psArgs, {
+      stdio: 'inherit', shell: false, windowsHide: true, env: childEnv,
+    });
+    if (result.error) throw new Error(`Could not run Windows PowerShell: ${result.error.message}`);
+    return result.status ?? 1;
+  } catch (error) {
+    console.error(`BurnBar: ${error.message}`);
+    return 1;
+  }
+}
+
+if (require.main === module) process.exitCode = main();
+module.exports = { parseArgs, invocation, main };

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "burnbar",
+  "version": "0.0.0-dev.37.1",
+  "description": "Install or update the BurnBar Windows taskbar usage meter",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nooblk-98/burnbar"
+  },
+  "homepage": "https://github.com/nooblk-98/burnbar#installation",
+  "bugs": {
+    "url": "https://github.com/nooblk-98/burnbar/issues"
+  },
+  "bin": {
+    "burnbar": "npm/bin/burnbar.cjs"
+  },
+  "files": [
+    "npm/bin/burnbar.cjs",
+    "install.ps1"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}