session-steward 0.5.2 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.6.0] - 2026-08-16
+
+### Added
+
+- Windows support, alongside macOS and Linux. Codex and Claude Code sessions are read from your Windows user profile, and Claude Desktop data is found in both the standalone and Microsoft Store locations.
+- Inside WSL, Session Steward manages the sessions stored in your Linux home folder. Run it from Windows to manage the sessions in your Windows profile.
+
 ## [0.5.2] - 2026-08-13
 
 ### Changed
@@ -105,6 +112,7 @@
 - Support for custom Codex home folders and a saved folder preference.
 - Streaming and bounded-memory discovery for large session collections and transcripts.
 
+[0.6.0]: https://github.com/mallikcheripally/session-steward/compare/v0.5.2...v0.6.0
 [0.5.2]: https://github.com/mallikcheripally/session-steward/compare/v0.5.1...v0.5.2
 [0.5.1]: https://github.com/mallikcheripally/session-steward/compare/v0.5.0...v0.5.1
 [0.5.0]: https://github.com/mallikcheripally/session-steward/compare/v0.4.0...v0.5.0

package/README.md

@@ -47,7 +47,7 @@ At startup, Session Steward may contact the public npm registry to check for a n
 
 ## Install and get started
 
-Session Steward supports macOS and Linux and requires Node.js 24.15 or newer. Git and a separate SQLite installation are not required.
+Session Steward supports macOS, Linux, and Windows and requires Node.js 24.15 or newer.
 
 Install it globally:
 
@@ -67,7 +67,9 @@ Or try it without installing:
 npx session-steward@latest
 ```
 
-Session Steward opens in your browser, listens only on `127.0.0.1`, and detects `~/.codex` and `~/.claude` by default. Claude Desktop sessions are detected on macOS; Claude Code CLI sessions work on macOS and Linux.
+Session Steward opens in your browser, listens only on `127.0.0.1`, and detects `~/.codex` and `~/.claude` by default. Claude Code CLI and local Claude Desktop sessions are detected on macOS and Windows; the Claude Code CLI is also supported on Linux. On Windows, these resolve to `%USERPROFILE%\.codex` and `%USERPROFILE%\.claude`.
+
+When run inside WSL, Session Steward uses the Linux home folder and manages sessions stored there. Run it from Windows to manage sessions in your Windows profile.
 
 To clean up sessions:
 
@@ -271,7 +273,7 @@ Results vary with hardware, disk speed, and session layout. Tests and benchmarks
 
 ## Support
 
-Codex, Claude Code CLI, and local Claude Code Desktop sessions are supported. Claude Desktop archive is not treated as deletion, and Session Steward never removes its worktrees.
+Codex, Claude Code CLI, and local Claude Code Desktop sessions are supported. Claude Desktop archive is not treated as deletion, and Session Steward never removes its worktrees. On Windows, both the standalone and Microsoft Store Claude Desktop data locations are detected.
 
 Use [GitHub Issues](https://github.com/mallikcheripally/session-steward/issues) to report a bug, request a provider, or share a storage format that Session Steward does not recognize.
 

package/bin/session-steward.mjs

@@ -4,6 +4,7 @@ import { parseArgs } from "node:util";
 import { spawn } from "node:child_process";
 
 import packageMetadata from "../package.json" with { type: "json" };
+import { getBrowserOpenInvocation } from "../lib/platform.mjs";
 import { assertSupportedNode } from "../lib/runtime.mjs";
 import { findAvailableUpdate, formatUpdateNotice } from "../lib/update-check.mjs";
 
@@ -58,14 +59,14 @@ process.stdout.write(`Session Steward is running at http://127.0.0.1:${server.po
 
 if (!values["no-open"]) {
   const url = `http://127.0.0.1:${server.port}`;
-  const openerCommand = process.platform === "darwin"
-    ? "open"
-    : process.platform === "linux"
-      ? "xdg-open"
-      : null;
+  const invocation = getBrowserOpenInvocation(url);
 
-  if (openerCommand) {
-    const opener = spawn(openerCommand, [url], { detached: true, stdio: "ignore" });
+  if (invocation) {
+    const opener = spawn(invocation.command, invocation.args, {
+      detached: true,
+      stdio: "ignore",
+      windowsHide: invocation.windowsHide,
+    });
     opener.unref();
   } else {
     process.stdout.write(`Open ${url} in a browser.\n`);

package/lib/platform.mjs

@@ -0,0 +1,178 @@
+import { existsSync, readdirSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+const WINDOWS_ROOTED = /^(?:[a-z]:[\\/]|[\\/]{2})/iu;
+
+function pathApi(platform) {
+  if (platform === "win32") {
+    return path.win32;
+  }
+
+  if (platform === "darwin" || platform === "linux") {
+    return path.posix;
+  }
+
+  return path;
+}
+
+function isUsableAbsolutePath(value, platform) {
+  if (typeof value !== "string" || !pathApi(platform).isAbsolute(value)) {
+    return false;
+  }
+
+  // path.win32.isAbsolute accepts root-relative paths such as "/home/user",
+  // which resolve against whichever drive happens to be current.
+  return platform !== "win32" || WINDOWS_ROOTED.test(value);
+}
+
+export function expandHomePath(value, {
+  home = os.homedir(),
+  platform = process.platform,
+} = {}) {
+  if (value === "~") {
+    return home;
+  }
+
+  if (typeof value === "string" && /^~[\\/]/u.test(value)) {
+    return pathApi(platform).join(home, value.slice(2));
+  }
+
+  return value;
+}
+
+export function getDefaultConfigDirectory({
+  env = process.env,
+  home = os.homedir(),
+  platform = process.platform,
+} = {}) {
+  const paths = pathApi(platform);
+  const xdgConfigHome = env.XDG_CONFIG_HOME;
+
+  if (isUsableAbsolutePath(xdgConfigHome, platform)) {
+    return paths.join(xdgConfigHome, "session-steward");
+  }
+
+  if (platform === "darwin") {
+    return paths.join(home, "Library", "Application Support", "session-steward");
+  }
+
+  if (platform === "win32") {
+    const appData = env.APPDATA;
+    return isUsableAbsolutePath(appData, platform)
+      ? paths.join(appData, "session-steward")
+      : paths.join(home, "AppData", "Roaming", "session-steward");
+  }
+
+  return paths.join(home, ".config", "session-steward");
+}
+
+const desktopDataHomeCache = new Map();
+
+export function invalidateClaudeDesktopDataHome() {
+  desktopDataHomeCache.clear();
+}
+
+function resolveClaudeDesktopDataHome({ env, fileSystem, home, platform }) {
+  const paths = pathApi(platform);
+
+  if (platform === "darwin") {
+    return paths.join(home, "Library", "Application Support", "Claude");
+  }
+
+  if (platform === "win32") {
+    const appData = env.APPDATA;
+    const standardHome = isUsableAbsolutePath(appData, platform)
+      ? paths.join(appData, "Claude")
+      : paths.join(home, "AppData", "Roaming", "Claude");
+    const sessionsName = "claude-code-sessions";
+
+    if (fileSystem.existsSync(paths.join(standardHome, sessionsName))) {
+      return standardHome;
+    }
+
+    const localAppData = env.LOCALAPPDATA;
+    if (isUsableAbsolutePath(localAppData, platform)) {
+      const packagesDirectory = paths.join(localAppData, "Packages");
+      try {
+        const packageEntries = fileSystem.readdirSync(packagesDirectory, { withFileTypes: true });
+        for (const entry of packageEntries) {
+          if (!entry.isDirectory() || !/^Claude_/iu.test(entry.name)) {
+            continue;
+          }
+
+          const packageHome = paths.join(
+            packagesDirectory,
+            entry.name,
+            "LocalCache",
+            "Roaming",
+            "Claude",
+          );
+          if (fileSystem.existsSync(paths.join(packageHome, sessionsName))) {
+            return packageHome;
+          }
+        }
+      } catch {
+      }
+    }
+
+    return standardHome;
+  }
+
+  return null;
+}
+
+export function getClaudeDesktopDataHome({
+  env = process.env,
+  fileSystem = { existsSync, readdirSync },
+  home = os.homedir(),
+  platform = process.platform,
+} = {}) {
+  // Windows discovery reads the file system, and this runs on every listing.
+  const key = `${platform}\0${home}\0${env.APPDATA || ""}\0${env.LOCALAPPDATA || ""}`;
+  if (desktopDataHomeCache.has(key)) {
+    return desktopDataHomeCache.get(key);
+  }
+
+  const resolved = resolveClaudeDesktopDataHome({ env, fileSystem, home, platform });
+  desktopDataHomeCache.set(key, resolved);
+  return resolved;
+}
+
+export function getBrowserOpenInvocation(url, {
+  env = process.env,
+  platform = process.platform,
+} = {}) {
+  if (platform === "darwin") {
+    return { args: [url], command: "open" };
+  }
+
+  if (platform === "linux") {
+    return { args: [url], command: "xdg-open" };
+  }
+
+  if (platform === "win32") {
+    return {
+      args: ["/d", "/s", "/c", "start", "", url],
+      command: env.ComSpec || env.COMSPEC || "cmd.exe",
+      windowsHide: true,
+    };
+  }
+
+  return null;
+}
+
+export function getCommandInvocation(command, args, {
+  env = process.env,
+  platform = process.platform,
+} = {}) {
+  if (platform !== "win32") {
+    return { args, command };
+  }
+
+  return {
+    args: ["/d", "/s", "/c", command, ...args],
+    command: env.ComSpec || env.COMSPEC || "cmd.exe",
+    windowsHide: true,
+  };
+}

package/lib/providers/claude-code/store.mjs

@@ -2,10 +2,14 @@ import { createHash, randomBytes } from "node:crypto";
 import { once } from "node:events";
 import { createReadStream, createWriteStream } from "node:fs";
 import { promises as fs } from "node:fs";
-import os from "node:os";
 import path from "node:path";
 import { finished, pipeline } from "node:stream/promises";
 
+import {
+  expandHomePath,
+  getClaudeDesktopDataHome,
+  invalidateClaudeDesktopDataHome,
+} from "../../platform.mjs";
 import { measurePath } from "../../storage/files.mjs";
 import { readJsonlEntries, rewriteJsonlFile } from "../../storage/jsonl.mjs";
 
@@ -34,19 +38,11 @@ const SESSION_SORTS = new Set(["created", "cwd", "name", "size", "updated"]);
 const discoveryCache = new Map();
 const transcriptActivityCache = new Map();
 
-function expandHome(value) {
-  if (value === "~") return os.homedir();
-  if (value?.startsWith("~/")) return path.join(os.homedir(), value.slice(2));
-  return value;
-}
-
 function getPaths(claudeHomeInput, desktopDataHomeInput) {
-  const claudeHome = path.resolve(expandHome(claudeHomeInput || process.env.CLAUDE_CONFIG_DIR || "~/.claude"));
+  const claudeHome = path.resolve(expandHomePath(claudeHomeInput || process.env.CLAUDE_CONFIG_DIR || "~/.claude"));
   const desktopDataHome = desktopDataHomeInput
-    ? path.resolve(expandHome(desktopDataHomeInput))
-    : process.platform === "darwin"
-      ? path.join(os.homedir(), "Library", "Application Support", "Claude")
-      : null;
+    ? path.resolve(expandHomePath(desktopDataHomeInput))
+    : getClaudeDesktopDataHome();
   return {
     backupRoot: path.join(claudeHome, "session-steward-backups"),
     claudeHome,
@@ -401,6 +397,9 @@ async function discover(claudeHome, desktopDataHome) {
 }
 
 async function discoverCached(claudeHome, desktopDataHome, { refresh = false } = {}) {
+  if (refresh && !desktopDataHome) {
+    invalidateClaudeDesktopDataHome();
+  }
   const paths = getPaths(claudeHome, desktopDataHome);
   const key = `${paths.claudeHome}\0${paths.desktopDataHome || ""}`;
   const cached = discoveryCache.get(key);
@@ -416,6 +415,7 @@ async function discoverCached(claudeHome, desktopDataHome, { refresh = false } =
 export function invalidateSessionCache({ claudeHome, desktopDataHome }) {
   const paths = getPaths(claudeHome, desktopDataHome);
   discoveryCache.delete(`${paths.claudeHome}\0${paths.desktopDataHome || ""}`);
+  invalidateClaudeDesktopDataHome();
 }
 
 function filterRecords(records, options) {

package/lib/providers/codex/store.mjs

@@ -1,7 +1,6 @@
 import { createHash } from "node:crypto";
 import { constants as fsConstants, createReadStream } from "node:fs";
 import { promises as fs } from "node:fs";
-import os from "node:os";
 import path from "node:path";
 import readline from "node:readline";
 
@@ -25,18 +24,7 @@ import {
   invalidateCodexDatabaseResolution,
   resolveCodexDatabases,
 } from "./database-families.mjs";
-
-function expandHome(value) {
-  if (!value || value === "~") {
-    return os.homedir();
-  }
-
-  if (value.startsWith("~/")) {
-    return path.join(os.homedir(), value.slice(2));
-  }
-
-  return value;
-}
+import { expandHomePath } from "../../platform.mjs";
 
 function normalizeText(value) {
   if (typeof value !== "string") {
@@ -448,7 +436,7 @@ function deriveDisplayName({
 }
 
 export function getCodexPaths(codexHomeInput, { refresh = false } = {}) {
-  const codexHome = path.resolve(expandHome(codexHomeInput || "~/.codex"));
+  const codexHome = path.resolve(expandHomePath(codexHomeInput || "~/.codex"));
   const archivedSessionsDirectory = path.join(codexHome, "archived_sessions");
   const sessionsDirectory = path.join(codexHome, "sessions");
   const resolution = resolveCodexDatabases(codexHome, { refresh });
@@ -1017,7 +1005,7 @@ async function getSessionSizeIndex(paths, { refresh = false } = {}) {
 }
 
 export function invalidateSessionCache({ codexHome }) {
-  const resolvedHome = path.resolve(expandHome(codexHome || "~/.codex"));
+  const resolvedHome = path.resolve(expandHomePath(codexHome || "~/.codex"));
   sessionSizeCache.delete(resolvedHome);
   invalidateCodexDatabaseResolution(resolvedHome);
 }

package/lib/server.mjs

@@ -12,6 +12,7 @@ import {
 } from "./session-event-reader.mjs";
 import { createProviderSettings } from "./settings.mjs";
 import { classifyInstalledVersion } from "./version-support.mjs";
+import { getCommandInvocation } from "./platform.mjs";
 
 const MAX_BODY_BYTES = 64 * 1024;
 const ALLOWED_SCOPES = new Set(["core", "deep"]);
@@ -32,7 +33,12 @@ const staticAssets = new Map([
 
 function readCommandVersion(command, args) {
   try {
-    return execFileSync(command, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim() || null;
+    const invocation = getCommandInvocation(command, args);
+    return execFileSync(invocation.command, invocation.args, {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+      windowsHide: invocation.windowsHide,
+    }).trim() || null;
   } catch {
     return null;
   }

package/lib/settings.mjs

@@ -3,6 +3,11 @@ import { promises as fs } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 
+import {
+  expandHomePath,
+  getDefaultConfigDirectory as resolveDefaultConfigDirectory,
+} from "./platform.mjs";
+
 const CONFIG_VERSION = 1;
 const PROVIDERS = {
   codex: {
@@ -21,24 +26,12 @@ const PROVIDERS = {
   },
 };
 
-function expandHome(value) {
-  if (value === "~") {
-    return os.homedir();
-  }
-
-  if (value.startsWith("~/")) {
-    return path.join(os.homedir(), value.slice(2));
-  }
-
-  return value;
-}
-
 function normalizeHome(value) {
   if (typeof value !== "string" || value.includes("\0")) {
     throw new Error("Enter a valid folder path.");
   }
 
-  const expanded = expandHome(value.trim());
+  const expanded = expandHomePath(value.trim());
 
   if (!expanded || !path.isAbsolute(expanded)) {
     throw new Error("Enter a full folder path, such as ~/.codex.");
@@ -58,17 +51,7 @@ function getProviderDefinition(providerId) {
 }
 
 export function getDefaultConfigDirectory() {
-  const xdgConfigHome = process.env.XDG_CONFIG_HOME;
-
-  if (xdgConfigHome && path.isAbsolute(xdgConfigHome)) {
-    return path.join(xdgConfigHome, "session-steward");
-  }
-
-  if (process.platform === "darwin") {
-    return path.join(os.homedir(), "Library", "Application Support", "session-steward");
-  }
-
-  return path.join(os.homedir(), ".config", "session-steward");
+  return resolveDefaultConfigDirectory();
 }
 
 async function readConfig(configPath) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "session-steward",
-  "version": "0.5.2",
-  "description": "A local Codex and Claude Code session manager for safely reviewing and deleting old sessions.",
+  "version": "0.6.0",
+  "description": "Codex and Claude Code session manager - browse, back up, and delete old sessions. Local browser UI + CLI.",
   "license": "MIT",
   "author": "Mallik Cheripally",
   "type": "module",
@@ -17,28 +17,25 @@
   "bugs": "https://github.com/mallikcheripally/session-steward/issues",
   "keywords": [
     "codex",
-    "claude-code",
-    "claude-code-sessions",
-    "claude-desktop",
     "codex-cli",
-    "openai-codex",
     "codex-sessions",
-    "codex-session-manager",
-    "codex-session-cleanup",
     "codex-cleanup",
-    "codex-history",
-    "delete-codex-sessions",
-    "session-manager",
-    "session-cleanup",
-    "ai-session-manager",
+    "openai-codex",
     "chatgpt-desktop",
-    "chatgpt-history",
-    "ai-coding-agent",
-    "chatgpt-app-cleanup"
+    "claude-code",
+    "claude-code-sessions",
+    "claude-code-cleanup",
+    "claude-desktop",
+    "session-cleanup",
+    "session-history",
+    "session-manager",
+    "disk-space",
+    "disk-cleanup"
   ],
   "os": [
     "darwin",
-    "linux"
+    "linux",
+    "win32"
   ],
   "files": [
     "bin",
@@ -56,6 +53,7 @@
   },
   "scripts": {
     "build": "vite build",
+    "benchmark:claude-discovery": "node --expose-gc test/benchmarks/claude-discovery.mjs",
     "benchmark:discovery": "node --expose-gc test/benchmarks/codex-discovery.mjs",
     "benchmark:events": "node --expose-gc test/benchmarks/session-events.mjs",
     "benchmark:overview": "node --expose-gc test/benchmarks/codex-overview.mjs",