Release 0.2.0

Fix Windows first-install statusline setup by generating a .cmd shim and using a PowerShell OTel profile block when appropriate.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: devartifex

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-05-14
+
+### Fixed
+
+- Fixed first-time Windows installs by generating a `copilot-cost.cmd` statusline shim and configuring Copilot CLI to use it.
+- Added PowerShell profile OpenTelemetry setup on Windows when no POSIX shell is active.
+- Preserved the existing POSIX shell shim behavior for macOS and Linux installs.
+
 ## [0.1.0] - 2026-05-14
 
 Initial public release.

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "copilot-cost",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Local-only GitHub Copilot CLI statusline + dashboard for real-time token cost tracking. Reads OpenTelemetry traces, never sends data anywhere.",
   "keywords": [
     "github",

package.json

@@ -20,6 +20,7 @@ export interface InstallPaths {
   shimPath: string;
   settingsPath: string;
   profilePath: string;
+  profileKind: "posix" | "powershell";
 }
 
 type JsonObject = Record<string, unknown>;
@@ -28,6 +29,10 @@ function currentHome(): string {
   return process.env.HOME || homedir();
 }
 
+function isWindows(): boolean {
+  return process.platform === "win32";
+}
+
 function pricingCachePath(home = currentHome()): string {
   return path.join(home, ".copilot", "cost-cache", "pricing.yaml");
 }
@@ -44,14 +49,23 @@ export function resolveInstallPaths(env: NodeJS.ProcessEnv = process.env): Insta
   const home = env.HOME || homedir();
   const copilotDir = path.join(home, ".copilot");
   const shell = path.basename(env.SHELL || "");
+  const profileKind = !shell && isWindows() ? "powershell" : "posix";
+  const powerShellProfileDir =
+    env.PSModulePath?.split(path.delimiter)
+      .map((entry) => path.normalize(entry))
+      .find((entry) => path.basename(entry).toLowerCase() === "modules" && path.basename(path.dirname(entry)).toLowerCase() === "powershell");
   const profileName = shell.includes("zsh") ? ".zshrc" : shell.includes("bash") ? ".bashrc" : ".profile";
   return {
     home,
     copilotDir,
     binDir: path.join(copilotDir, "bin"),
-    shimPath: path.join(copilotDir, "bin", "copilot-cost"),
+    shimPath: path.join(copilotDir, "bin", isWindows() ? "copilot-cost.cmd" : "copilot-cost"),
     settingsPath: path.join(copilotDir, "settings.json"),
-    profilePath: path.join(home, profileName),
+    profilePath:
+      profileKind === "powershell"
+        ? path.join(powerShellProfileDir ? path.dirname(powerShellProfileDir) : path.join(home, "Documents", "PowerShell"), "Microsoft.PowerShell_profile.ps1")
+        : path.join(home, profileName),
+    profileKind,
   };
 }
 
@@ -63,14 +77,24 @@ function shellQuote(value: string): string {
   return `'${value.replaceAll("'", `'\\''`)}'`;
 }
 
-export function otelBlock(): string {
-  return [
-    OTEL_BEGIN,
-    "export COPILOT_OTEL_ENABLED=true",
-    "export COPILOT_OTEL_EXPORTER_TYPE=file",
-    'export COPILOT_OTEL_FILE_EXPORTER_PATH="$HOME/.copilot/otel/copilot-otel.jsonl"',
-    OTEL_END,
-  ].join("\n");
+export function otelBlock(profileKind: "posix" | "powershell" = resolveInstallPaths().profileKind): string {
+  const lines =
+    profileKind === "powershell"
+      ? [
+          OTEL_BEGIN,
+          "$env:COPILOT_OTEL_ENABLED = 'true'",
+          "$env:COPILOT_OTEL_EXPORTER_TYPE = 'file'",
+          "$env:COPILOT_OTEL_FILE_EXPORTER_PATH = Join-Path $HOME '.copilot/otel/copilot-otel.jsonl'",
+          OTEL_END,
+        ]
+      : [
+          OTEL_BEGIN,
+          "export COPILOT_OTEL_ENABLED=true",
+          "export COPILOT_OTEL_EXPORTER_TYPE=file",
+          'export COPILOT_OTEL_FILE_EXPORTER_PATH="$HOME/.copilot/otel/copilot-otel.jsonl"',
+          OTEL_END,
+        ];
+  return lines.join("\n");
 }
 
 function readJsonObject(filePath: string): JsonObject {
@@ -99,12 +123,12 @@ export function hasOtelBlock(profilePath: string): boolean {
   return existsSync(profilePath) && readFileSync(profilePath, "utf-8").includes(OTEL_BEGIN);
 }
 
-export function appendOtelExporterBlock(profilePath = resolveInstallPaths().profilePath): "appended" | "already-present" {
+export function appendOtelExporterBlock(profilePath = resolveInstallPaths().profilePath, profileKind = resolveInstallPaths().profileKind): "appended" | "already-present" {
   mkdirSync(path.dirname(profilePath), { recursive: true });
   const existing = existsSync(profilePath) ? readFileSync(profilePath, "utf-8") : "";
   if (existing.includes(OTEL_BEGIN)) return "already-present";
   const prefix = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
-  writeFileSync(profilePath, `${existing}${prefix}${otelBlock()}\n`, "utf-8");
+  writeFileSync(profilePath, `${existing}${prefix}${otelBlock(profileKind)}\n`, "utf-8");
   return "appended";
 }
 
@@ -120,9 +144,9 @@ export function removeOtelExporterBlock(profilePath = resolveInstallPaths().prof
 function writeShim(shimPath: string): void {
   mkdirSync(path.dirname(shimPath), { recursive: true });
   const target = cliPathFromInstallModule();
-  const body = `#!/bin/sh\nexec node ${shellQuote(target)} render "$@"\n`;
+  const body = isWindows() ? `@echo off\r\nnode "${target}" render %*\r\n` : `#!/bin/sh\nexec node ${shellQuote(target)} render "$@"\n`;
   writeFileSync(shimPath, body, "utf-8");
-  chmodSync(shimPath, 0o755);
+  if (!isWindows()) chmodSync(shimPath, 0o755);
 }
 
 function installSettings(settingsPath: string, shimPath: string): "updated" | "already-configured" {
@@ -148,9 +172,9 @@ export async function cmdInstall(opts: { yes?: boolean; otelProfile?: boolean }
   let otelAction: "appended" | "already-present" | "skipped" = "skipped";
   const shouldOfferProfileEdit = opts.otelProfile !== false;
   if (!shouldOfferProfileEdit) {
-    console.log(`OTel profile edit skipped. Add this block to your shell profile to enable capture:\n${otelBlock()}`);
+    console.log(`OTel profile edit skipped. Add this block to your shell profile to enable capture:\n${otelBlock(paths.profileKind)}`);
   } else {
-    otelAction = appendOtelExporterBlock(paths.profilePath);
+    otelAction = appendOtelExporterBlock(paths.profilePath, paths.profileKind);
   }
 
   await refreshPricing({ force: false, dest: pricingCachePath(paths.home) });
@@ -250,7 +274,7 @@ export async function cmdDoctor(): Promise<number> {
     okLine("sample render", false, error instanceof Error ? error.message : String(error));
   }
 
-  const executable = existsSync(paths.shimPath) && (statSync(paths.shimPath).mode & 0o111) !== 0;
+  const executable = existsSync(paths.shimPath) && (isWindows() || (statSync(paths.shimPath).mode & 0o111) !== 0);
   if (!okLine("shim executable", executable, paths.shimPath)) failed = true;
   const dashboardDir = path.resolve(packageRoot(import.meta.url), "dashboard-ui", "dist");
   const missingDashboardFiles = ["index.html", "app.js", "styles.css"].filter((file) => !existsSync(path.join(dashboardDir, file)));

src/install.ts

@@ -4,12 +4,13 @@ import path from "node:path";
 
 const root = path.resolve(".test-home", "install-tests");
 const savedEnv = { ...process.env };
+const shimName = process.platform === "win32" ? "copilot-cost.cmd" : "copilot-cost";
 
-function resetHome(name: string): string {
+function resetHome(name: string, overrides: NodeJS.ProcessEnv = { SHELL: "/bin/zsh" }): string {
   vi.resetModules();
   const home = path.join(root, name);
   rmSync(home, { recursive: true, force: true });
-  process.env = { ...savedEnv, HOME: home, SHELL: "/bin/zsh", COPILOT_COST_REFRESH_DAYS: "999999" };
+  process.env = { ...savedEnv, HOME: home, COPILOT_COST_REFRESH_DAYS: "999999", ...overrides };
   return home;
 }
 
@@ -29,13 +30,13 @@ describe("install commands", () => {
     const { cmdInstall } = await import("../src/install.js");
     await expect(cmdInstall({ yes: true })).resolves.toBe(0);
 
-    const shim = path.join(home, ".copilot", "bin", "copilot-cost");
+    const shim = path.join(home, ".copilot", "bin", shimName);
     const otelDir = path.join(home, ".copilot", "otel");
     const settingsPath = path.join(home, ".copilot", "settings.json");
     const profilePath = path.join(home, ".zshrc");
     expect(existsSync(shim)).toBe(true);
     expect(existsSync(otelDir)).toBe(true);
-    expect(statSync(shim).mode & 0o111).not.toBe(0);
+    if (process.platform !== "win32") expect(statSync(shim).mode & 0o111).not.toBe(0);
     const settings = JSON.parse(readFileSync(settingsPath, "utf-8")) as { statusLine: { command: string } };
     expect(settings.statusLine.command).toBe(shim);
     expect(readFileSync(profilePath, "utf-8")).toContain("copilot-cost OTel exporter");
@@ -62,13 +63,26 @@ describe("install commands", () => {
     expect(output).not.toContain("Append OTel exporter settings");
   });
 
+  it("uses a PowerShell profile block on Windows when no POSIX shell is active", async () => {
+    if (process.platform !== "win32") return;
+    const home = resetHome("powershell-profile", {
+      SHELL: "",
+      PSModulePath: path.join(root, "powershell-profile", "Documents", "PowerShell", "Modules"),
+    });
+    const { cmdInstall } = await import("../src/install.js");
+    await expect(cmdInstall({ yes: true })).resolves.toBe(0);
+
+    const profilePath = path.join(home, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1");
+    expect(readFileSync(profilePath, "utf-8")).toContain("$env:COPILOT_OTEL_ENABLED = 'true'");
+  });
+
   it("uninstall reverses install", async () => {
     const home = resetHome("uninstall");
     const { cmdInstall, cmdUninstall } = await import("../src/install.js");
     await cmdInstall({ yes: true });
     await expect(cmdUninstall({ yes: true })).resolves.toBe(0);
 
-    const shim = path.join(home, ".copilot", "bin", "copilot-cost");
+    const shim = path.join(home, ".copilot", "bin", shimName);
     const settings = JSON.parse(readFileSync(path.join(home, ".copilot", "settings.json"), "utf-8")) as Record<string, unknown>;
     expect(existsSync(shim)).toBe(false);
     expect(settings.statusLine).toBeUndefined();