claude-code-hub 1.2.1 → 1.3.1

package/README.md

@@ -58,10 +58,13 @@ Explore the memory files that Claude Code loads for a project.
 ## Quick start
 
 ```bash
-npx claude-code-hub --open
+npm i -g claude-code-hub
+claude-code-hub --open
 ```
 
-The hub starts on `http://localhost:3540` and opens the browser. To get a window with no browser UI, install the page as an app from the browser menu.
+The hub starts on `http://localhost:3540` and opens the browser. To get a window with no browser UI, install the page as an app from the browser menu. To update, run `npm i -g claude-code-hub@latest`.
+
+To try the hub without installing it, run `npx claude-code-hub --open`. Each npx version runs from a different cache folder, so use a global install to keep the hub.
 
 ### From source
 
@@ -177,10 +180,25 @@ The shortcuts also work when focus is inside a tool. Kanban keeps <kbd>Ctrl</kbd
 --host <addr>           Bind address (default: 127.0.0.1)
 --allowed-hosts <list>  Extra host names to accept, comma-separated
 --open                  Open the browser on start
+--tray                  Windows: run the hub from a tray icon
+--autostart             Windows: same as --tray, and start the tray at logon
+--no-autostart          Windows: stop starting the tray at logon
+--tray-status           Windows: show whether autostart is on and the tray and hub are running
+--app-id <id>           Windows, with --tray or --autostart: the installed app that Open Hub starts
 ```
 
 If a port is busy, the hub uses a free port and reports it.
 
+## Tray icon (Windows)
+
+```
+claude-code-hub --autostart
+```
+
+The hub runs in the background with an icon in the notification area. Click the icon to open the hub. Right-click it to stop, start or restart the hub, open its log, turn **Start with Windows** on or off, or quit. The dot on the icon shows the state: green is running, amber is starting, red is stopped. If the hub stops unexpectedly, the tray shows a notice and turns red; start the hub again from the menu.
+
+To turn off autostart, untick **Start with Windows** or run `claude-code-hub --no-autostart`. To check the state, run `claude-code-hub --tray-status`. See [Run the hub from the tray](https://nikiforovall.blog/claude-code-hub/guides/tray/).
+
 ## Included tools
 
 | Tool | Docs | Repo | Submodule | Default port |

package/lib/hub-record.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const fs = require('node:fs');
+const http = require('node:http');
+const path = require('node:path');
+
+function recordFile(hubDir) {
+  return path.join(hubDir, 'hub.json');
+}
+
+function readRecord(hubDir) {
+  try {
+    return JSON.parse(fs.readFileSync(recordFile(hubDir), 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeRecord(hubDir, port) {
+  fs.writeFileSync(recordFile(hubDir), `${JSON.stringify({ pid: process.pid, port })}\n`);
+}
+
+function removeRecord(hubDir) {
+  if (readRecord(hubDir)?.pid === process.pid) fs.rmSync(recordFile(hubDir), { force: true });
+}
+
+// A killed hub leaves its record behind, and its pid and port can be reused, so only a hub that
+// accepts this hub dir's token counts as live. http.get with no agent, not fetch: the callers exit
+// right after, and on Windows process.exit with an undici socket still closing trips a libuv assertion.
+function liveHub(hubDir, token) {
+  const record = readRecord(hubDir);
+  if (!Number.isInteger(record?.port)) return Promise.resolve(null);
+  return new Promise((resolve) => {
+    const req = http.get(
+      { host: '127.0.0.1', port: record.port, path: `/api/config?token=${token}`, agent: false, timeout: 2000 },
+      (res) => {
+        res.resume();
+        resolve(res.statusCode === 200 ? record : null);
+      },
+    );
+    req.on('timeout', () => req.destroy());
+    req.on('error', () => resolve(null));
+  });
+}
+
+module.exports = { writeRecord, removeRecord, liveHub };

package/lib/tray.js

@@ -0,0 +1,100 @@
+'use strict';
+
+const { execFileSync, spawn } = require('node:child_process');
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+const { version } = require('../package.json');
+const { liveHub } = require('./hub-record');
+
+const TRAY_SRC = path.join(__dirname, '..', 'tray');
+const RUN_KEY = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Run';
+
+// One Run value and one tray per hub dir, so a test hub never replaces the real autostart.
+function runValue(hubDir) {
+  const hash = crypto.createHash('sha1').update(path.resolve(hubDir).toLowerCase()).digest('hex').slice(0, 8);
+  return `ClaudeCodeHub-${hash}`;
+}
+
+// An installed app is bound to the origin it was installed from, and its shortcut does not record
+// it, so the tray opens the app only when the hub runs on the port the app is assumed to serve.
+function appConfig({ appId, port, defaultPort }) {
+  return appId ? { id: appId, port } : { name: 'Claude Code Hub', port: defaultPort };
+}
+
+// The Run key and the tray start from this copy, never from the package: an npx cache path can vanish.
+function copyTray({ hubDir, port, appId, defaultPort, value }) {
+  const dest = path.join(hubDir, 'tray');
+  fs.rmSync(dest, { recursive: true, force: true });
+  fs.cpSync(TRAY_SRC, dest, { recursive: true });
+  const config = {
+    port,
+    app: appConfig({ appId, port, defaultPort }),
+    version,
+    serverJs: path.join(__dirname, '..', 'server.js'),
+    node: process.execPath,
+    runValue: value,
+  };
+  fs.writeFileSync(path.join(dest, 'config.json'), `${JSON.stringify(config, null, 2)}\n`);
+  return path.join(dest, 'launch.vbs');
+}
+
+// A pid file outlives its process, and Windows reuses pids, so the image name must match too.
+function pidAlive(pid, image) {
+  if (!Number.isInteger(pid)) return false;
+  const out = execFileSync('tasklist', ['/fi', `PID eq ${pid}`, '/fo', 'csv', '/nh'], { encoding: 'utf8' });
+  return out.toLowerCase().startsWith(`"${image}"`);
+}
+
+async function printStatus({ hubDir, configDir, value }) {
+  let autostart = 'off';
+  try {
+    execFileSync('reg', ['query', RUN_KEY, '/v', value], { stdio: 'ignore' });
+    autostart = `on (${value})`;
+  } catch {}
+  let trayPid = null;
+  try {
+    trayPid = Number.parseInt(fs.readFileSync(path.join(hubDir, 'tray.pid'), 'utf8'), 10);
+  } catch {}
+  let hub = null;
+  try {
+    hub = await liveHub(hubDir, fs.readFileSync(path.join(hubDir, 'token'), 'utf8').trim());
+  } catch {}
+  console.log(`  Hub dir: ${hubDir}`);
+  console.log(`  Config dir: ${configDir}`);
+  console.log(`  Autostart: ${autostart}`);
+  console.log(`  Tray: ${pidAlive(trayPid, 'powershell.exe') ? `running (pid ${trayPid})` : 'not running'}`);
+  console.log(`  Hub: ${hub ? `running on port ${hub.port} (pid ${hub.pid})` : 'stopped'}`);
+}
+
+async function runTrayCommand({ flag, hubDir, port, defaultPort, appId, configDir, platform = process.platform }) {
+  if (platform !== 'win32') {
+    console.error(`  ${flag} works only on Windows.`);
+    return false;
+  }
+  const value = runValue(hubDir);
+  if (flag === '--tray-status') {
+    await printStatus({ hubDir, configDir, value });
+    return true;
+  }
+  if (flag === '--no-autostart') {
+    try {
+      execFileSync('reg', ['delete', RUN_KEY, '/v', value, '/f'], { stdio: 'ignore' });
+      console.log('  Autostart: removed');
+    } catch {
+      console.log('  Autostart: not set');
+    }
+    return true;
+  }
+  const vbs = copyTray({ hubDir, port, appId, defaultPort, value });
+  console.log(`  Tray copy: ${path.dirname(vbs)}`);
+  if (flag === '--autostart') {
+    execFileSync('reg', ['add', RUN_KEY, '/v', value, '/t', 'REG_SZ', '/d', `wscript.exe "${vbs}"`, '/f'], { stdio: 'ignore' });
+    console.log('  Autostart: on (starts at logon)');
+  }
+  spawn('wscript.exe', [vbs], { detached: true, stdio: 'ignore' }).unref();
+  console.log('  Tray: started. Look for the hub icon in the notification area.');
+  return true;
+}
+
+module.exports = { runTrayCommand, runValue, appConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-hub",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "Unified hub for Claude Code tools — Marketplace + Kanban in one PWA",
   "main": "server.js",
   "bin": {
@@ -46,7 +46,7 @@
   "homepage": "https://github.com/NikiforovAll/claude-code-hub#readme",
   "dependencies": {
     "claude-code-cost": "1.2.0",
-    "claude-code-kanban": "5.4.0",
+    "claude-code-kanban": "6.1.1",
     "claude-code-marketplace": "1.3.0",
     "claude-code-memory-explorer": "1.1.1",
     "express": "^4.21.0",
@@ -60,6 +60,7 @@
     "public/**/*",
     "lib/**/*",
     "plugin/**/*",
+    "tray/**/*",
     "packages/claude-hub-sdk/src/**/*"
   ],
   "devDependencies": {

package/server.js

@@ -16,6 +16,7 @@ const { ping, stats } = require('./lib/ipc');
 const { killChild } = require('./lib/kill-child');
 const { readRegistry, themeConfig } = require('./lib/themes');
 const { createUpdateCheck } = require('./lib/update-check');
+const { liveHub, removeRecord, writeRecord } = require('./lib/hub-record');
 const { version: HUB_VERSION } = require('./package.json');
 
 function getArg(name) {
@@ -26,7 +27,8 @@ function getArg(name) {
   return process.argv[idx + 1] || null;
 }
 
-const HUB_PORT = parseInt(getArg('port') || process.env.PORT || '3540', 10);
+const DEFAULT_HUB_PORT = 3540;
+const HUB_PORT = parseInt(getArg('port') || process.env.PORT || DEFAULT_HUB_PORT, 10);
 let hubPort = HUB_PORT;
 
 const POOL_SIZE = Math.max(1, parseInt(getArg('pool-size') || '3', 10));
@@ -51,6 +53,19 @@ function activePool() {
 const HUB_DIR = path.resolve(expandHome(getArg('hub-dir') || process.env.CLAUDE_HUB_DIR || '~/.claude-hub'));
 const HUB_CONFIG_FILE = path.join(HUB_DIR, 'config.json');
 
+const TRAY_FLAG = ['--tray', '--autostart', '--no-autostart', '--tray-status'].find((f) => process.argv.includes(f));
+if (TRAY_FLAG) {
+  const { runTrayCommand } = require('./lib/tray');
+  runTrayCommand({
+    flag: TRAY_FLAG,
+    hubDir: HUB_DIR,
+    port: HUB_PORT,
+    defaultPort: DEFAULT_HUB_PORT,
+    appId: getArg('app-id'),
+    configDir: resolveHubConfig().config.activeConfigDir,
+  }).then((ok) => process.exit(ok ? 0 : 1));
+}
+
 if (process.argv.includes('--install') || process.argv.includes('--uninstall')) {
   const { runInstall, runUninstall } = require('./lib/install');
   const dir = getArg('dir') || process.env.CLAUDE_CONFIG_DIR || '~/.claude';
@@ -82,6 +97,14 @@ function canonicalDir(p) {
 }
 
 function loadHubConfig() {
+  const { config, raw, fallback } = resolveHubConfig();
+  defaultConfigDir = fallback;
+  // Configs saved before canonicalization can hold one dir under two spellings; persist the merge.
+  if (serializeConfig(config) !== raw) writeHubConfig(config);
+  return config;
+}
+
+function resolveHubConfig() {
   const canonical = (p) => {
     try {
       return canonicalDir(p);
@@ -92,7 +115,6 @@ function loadHubConfig() {
   const fallback = canonical(
     process.env.CLAUDE_CONFIG_DIR || process.env.CLAUDE_DIR || path.join(os.homedir(), '.claude'),
   );
-  defaultConfigDir = fallback;
   let raw = '';
   let saved = {};
   try {
@@ -108,9 +130,7 @@ function loadHubConfig() {
   // Hand-edited only; kept verbatim so a rewrite of the file does not drop it.
   if (saved.terminal && typeof saved.terminal === 'object') config.terminal = saved.terminal;
   if (Array.isArray(saved.apps)) config.apps = saved.apps;
-  // Configs saved before canonicalization can hold one dir under two spellings; persist the merge.
-  if (serializeConfig(config) !== raw) writeHubConfig(config);
-  return config;
+  return { config, raw, fallback };
 }
 
 function serializeConfig(config) {
@@ -398,20 +418,24 @@ process.on('SIGINT', shutdown);
 process.on('SIGTERM', shutdown);
 process.on('SIGHUP', shutdown);
 process.on('exit', killAll);
-
-// Git Bash + tmux on Windows doesn't deliver signals — read stdin directly
-process.stdin.setEncoding('utf8');
-process.stdin.resume();
-process.stdin.on('data', (data) => {
-  const d = data.trim().toLowerCase();
-  // Ctrl+C (0x03), Ctrl+D (0x04), or typed "q"/"exit"
-  if (data.includes('\x03') || data.includes('\x04') || d === 'q' || d === 'exit') {
-    console.log('\nShutting down...');
-    shutdown();
-  }
-});
-process.stdin.on('end', shutdown);
-process.stdin.on('close', shutdown);
+process.on('exit', () => removeRecord(HUB_DIR));
+
+// Git Bash + tmux on Windows doesn't deliver signals — read stdin directly. Only a hub that starts
+// watches it: a closed stdin would end a CLI command or the running-hub check halfway.
+function watchStdin() {
+  process.stdin.setEncoding('utf8');
+  process.stdin.resume();
+  process.stdin.on('data', (data) => {
+    const d = data.trim().toLowerCase();
+    // Ctrl+C (0x03), Ctrl+D (0x04), or typed "q"/"exit"
+    if (data.includes('\x03') || data.includes('\x04') || d === 'q' || d === 'exit') {
+      console.log('\nShutting down...');
+      shutdown();
+    }
+  });
+  process.stdin.on('end', shutdown);
+  process.stdin.on('close', shutdown);
+}
 
 // Raise header size limit to 64KB — localhost cookies from sibling apps can pile up and
 // trip Node's default 16KB limit, breaking iframes with HTTP 431.
@@ -798,16 +822,18 @@ function listenWithFallback(handler, port, onReady, label, onUpgrade) {
   return server;
 }
 
-for (const [name, port] of Object.entries(publicPorts)) {
-  listenWithFallback(
-    proxyHandler(name),
-    port,
-    (actual) => {
-      publicPorts[name] = actual;
-    },
-    `[${name}] `,
-    proxyUpgrade(name),
-  );
+function listenProxies() {
+  for (const [name, port] of Object.entries(publicPorts)) {
+    listenWithFallback(
+      proxyHandler(name),
+      port,
+      (actual) => {
+        publicPorts[name] = actual;
+      },
+      `[${name}] `,
+      proxyUpgrade(name),
+    );
+  }
 }
 
 const app = express();
@@ -1000,6 +1026,13 @@ app.get('/api/projects', async (_req, res) => {
   }
 });
 
+// The tray stops the hub through this rather than taskkill, so the children and hub.json are cleaned up.
+app.post('/api/shutdown', (_req, res) => {
+  console.log('Shutdown asked for over the API');
+  res.on('finish', shutdown);
+  res.json({ ok: true });
+});
+
 // List-picked project paths skip this: they are byte-exact copies of what kanban reported.
 app.get('/api/resolve-path', (req, res) => {
   res.setHeader('Cache-Control', 'no-store');
@@ -1014,6 +1047,7 @@ app.use(express.static(path.join(__dirname, 'public')));
 // the hub actually bound: HUB_PORT may be busy and fall back to a random one.
 const onReady = (actual) => {
   hubPort = actual;
+  writeRecord(HUB_DIR, actual);
   ensurePool(hubConfig.activeConfigDir);
   updateCheck.refresh();
   printBanner(actual);
@@ -1022,7 +1056,24 @@ const onReady = (actual) => {
   }
 };
 
-listenWithFallback(app, HUB_PORT, onReady, '');
+// One hub per hub dir: a second one would overwrite hub.json, and the first would run unseen.
+// A tray flag's command is still running here and exits on its own.
+if (!TRAY_FLAG) {
+  liveHub(HUB_DIR, HUB_TOKEN).then((running) => {
+    if (!running) {
+      watchStdin();
+      listenProxies();
+      listenWithFallback(app, HUB_PORT, onReady, '');
+      return;
+    }
+    console.log(`Claude Code Hub already runs for ${HUB_DIR} at ${accessUrl(running.port)}`);
+    if (process.argv.includes('--open')) {
+      import('open').then((m) => m.default(accessUrl(running.port))).finally(() => process.exit(0));
+    } else {
+      process.exit(0);
+    }
+  });
+}
 
 function accessUrl(port) {
   return `http://localhost:${port}/?token=${HUB_TOKEN}`;

package/tray/hub-tray.ps1

@@ -0,0 +1,230 @@
+Add-Type -AssemblyName System.Windows.Forms, System.Drawing
+# DPI-aware, so the icon is drawn at the tray's real size instead of 16 px scaled up.
+Add-Type -Namespace HubTray -Name Native -MemberDefinition '[DllImport("user32.dll")] public static extern bool SetProcessDPIAware();'
+[void][HubTray.Native]::SetProcessDPIAware()
+[System.Windows.Forms.Application]::EnableVisualStyles()
+. (Join-Path $PSScriptRoot 'icon.ps1')
+
+$TrayDir = $PSScriptRoot
+$ConfigFile = Join-Path $TrayDir 'config.json'
+if (-not (Test-Path $ConfigFile)) {
+  [System.Windows.Forms.MessageBox]::Show("Missing $ConfigFile. Run: claude-code-hub --tray", 'Claude Code Hub') | Out-Null
+  exit 1
+}
+$config = Get-Content $ConfigFile -Raw | ConvertFrom-Json
+
+# createdNew, not WaitOne: a killed tray leaves the mutex abandoned, and WaitOne then throws instead of returning false.
+$createdNew = $false
+$mutex = New-Object System.Threading.Mutex($false, "Local\$($config.runValue)", [ref]$createdNew)
+if (-not $createdNew) { exit }
+
+$HubDir = Split-Path $TrayDir
+$RunKey = 'Registry::HKCU\Software\Microsoft\Windows\CurrentVersion\Run'
+$TrayPidFile = Join-Path $HubDir 'tray.pid'
+Set-Content -Path $TrayPidFile -Value $PID
+$HubFile = Join-Path $HubDir 'hub.json'
+$LogFile = Join-Path $HubDir 'hub.log'
+$TrayLog = Join-Path $HubDir 'tray.log'
+
+$script:hubProc = $null
+$script:hub = $null
+$script:state = ''
+$script:appLnk = $null
+
+function Write-TrayLog($msg) {
+  Add-Content -Path $TrayLog -Value "$(Get-Date -Format s) $msg"
+}
+
+# The hub writes hub.json once it listens; a dead pid there is a hub that is gone. Get-Process still
+# returns a killed process while any handle to it is open, so HasExited is checked too.
+function Get-Hub {
+  if (-not (Test-Path $HubFile)) { return $null }
+  $hub = Get-Content $HubFile -Raw | ConvertFrom-Json
+  $proc = Get-Process -Id $hub.pid -ErrorAction SilentlyContinue
+  if ($proc -and $proc.ProcessName -eq 'node' -and -not $proc.HasExited) { return $hub }
+  return $null
+}
+
+# The saved node comes first: the app packages were installed with it, and a version manager may
+# have switched the one on PATH since.
+function Get-HubCommand {
+  $hubArgs = "--hub-dir `"$HubDir`" --port $($config.port)"
+  $node = if (Test-Path $config.node) { $config.node } else { (Get-Command node.exe -ErrorAction SilentlyContinue | Select-Object -First 1).Source }
+  if ($node -and (Test-Path $config.serverJs)) {
+    return "`"$node`" `"$($config.serverJs)`" $hubArgs"
+  }
+  $tray.ShowBalloonTip(5000, 'Claude Code Hub', "The installed hub is gone. Starting $($config.version) with npx.", 'Warning')
+  return "npx -y claude-code-hub@$($config.version) $hubArgs"
+}
+
+function Start-Hub {
+  if (-not (Get-Hub)) {
+    if ((Test-Path $LogFile) -and (Get-Item $LogFile).Length -gt 5MB) { Move-Item $LogFile "$LogFile.1" -Force }
+    $cmd = Get-HubCommand
+    Write-TrayLog "start: $cmd"
+    $psi = New-Object System.Diagnostics.ProcessStartInfo
+    $psi.FileName = $env:ComSpec
+    $psi.Arguments = "/d /s /c `"$cmd >> `"$LogFile`" 2>&1`""
+    $psi.UseShellExecute = $false
+    $psi.CreateNoWindow = $true
+    $psi.WorkingDirectory = $HubDir
+    $script:hubProc = [System.Diagnostics.Process]::Start($psi)
+  }
+  Update-State
+}
+
+function Get-Token {
+  (Get-Content (Join-Path $HubDir 'token') -Raw).Trim()
+}
+
+# The shutdown route lets the hub stop its tools and remove hub.json; taskkill is the fallback for a
+# hub that does not answer. Killing the node tree also ends the cmd that the tray started.
+function Stop-Hub {
+  $hub = Get-Hub
+  if ($hub) {
+    Write-TrayLog "stop: pid $($hub.pid)"
+    try {
+      Invoke-RestMethod -Method Post -Uri "http://127.0.0.1:$($hub.port)/api/shutdown?token=$(Get-Token)" -TimeoutSec 3 | Out-Null
+      Wait-Process -Id $hub.pid -Timeout 15 -ErrorAction SilentlyContinue
+    } catch {
+      Write-TrayLog "shutdown request failed: $_"
+    }
+  }
+  $id = if (Get-Hub) { $hub.pid } elseif ($script:hubProc -and -not $script:hubProc.HasExited) { $script:hubProc.Id }
+  if ($id) {
+    Write-TrayLog "kill: pid $id"
+    & taskkill.exe /f /t /pid $id 2>&1 | Out-Null
+  }
+  if ($script:hubProc) {
+    [void]$script:hubProc.WaitForExit(5000)
+    $script:hubProc.Dispose()
+    $script:hubProc = $null
+  }
+  if ($hub) { Wait-Process -Id $hub.pid -Timeout 5 -ErrorAction SilentlyContinue }
+}
+
+$Shell = New-Object -ComObject WScript.Shell
+
+# Chrome and Edge put an installed app's shortcut in the Start Menu, with the app id in its arguments.
+function Find-AppShortcut {
+  if ($script:appLnk -and (Test-Path $script:appLnk.FullName)) { return $script:appLnk }
+  $script:appLnk = $null
+  $filter = if ($config.app.id) { '*.lnk' } else { "$($config.app.name).lnk" }
+  foreach ($file in Get-ChildItem "$env:APPDATA\Microsoft\Windows\Start Menu\Programs" -Recurse -Filter $filter -ErrorAction SilentlyContinue) {
+    $lnk = $Shell.CreateShortcut($file.FullName)
+    if ($lnk.Arguments -notmatch '--app-id=(\w+)') { continue }
+    if (-not $config.app.id -or $Matches[1] -eq $config.app.id) { $script:appLnk = $lnk; return $lnk }
+  }
+  return $null
+}
+
+# Chrome loads any URL into an app, so a hub on another port must not open in it.
+function Open-Hub {
+  $hub = Get-Hub
+  if (-not $hub) { return }
+  $url = "http://localhost:$($hub.port)/?token=$(Get-Token)"
+  $app = if ($hub.port -eq $config.app.port) { Find-AppShortcut }
+  if ($app) {
+    Start-Process $app.TargetPath "$($app.Arguments) --app-launch-url-for-shortcuts-menu-item=`"$url`""
+  } else {
+    Start-Process $url
+  }
+}
+
+function Get-Autostart {
+  $null -ne (Get-ItemProperty $RunKey -Name $config.runValue -ErrorAction SilentlyContinue)
+}
+
+$icons = @{}
+$iconSize = [System.Windows.Forms.SystemInformation]::SmallIconSize.Width
+foreach ($s in $StateColors.Keys) {
+  $bmp = New-TrayBitmap $iconSize $StateColors[$s]
+  $icons[$s] = [System.Drawing.Icon]::FromHandle($bmp.GetHicon())
+  $bmp.Dispose()
+}
+
+function Get-ConfigDirName {
+  try {
+    $dir = (Get-Content (Join-Path $HubDir 'config.json') -Raw | ConvertFrom-Json).activeConfigDir
+    if ($dir) { return Split-Path $dir -Leaf }
+  } catch {}
+  return $null
+}
+
+# The classic ContextMenu is a native Win32 menu, so it takes the Windows 11 menu style; ContextMenuStrip draws its own.
+$tray = New-Object System.Windows.Forms.NotifyIcon
+$menu = New-Object System.Windows.Forms.ContextMenu
+$miHeader = New-Object System.Windows.Forms.MenuItem 'Claude Code Hub'
+$miHeader.Enabled = $false
+$miOpen = New-Object System.Windows.Forms.MenuItem 'Open Hub'
+$miOpen.DefaultItem = $true
+$miStartStop = New-Object System.Windows.Forms.MenuItem 'Stop Hub'
+$miRestart = New-Object System.Windows.Forms.MenuItem 'Restart Hub'
+$miLog = New-Object System.Windows.Forms.MenuItem 'Open log'
+$miAuto = New-Object System.Windows.Forms.MenuItem 'Start with Windows'
+$miQuit = New-Object System.Windows.Forms.MenuItem 'Quit (stops the hub)'
+foreach ($item in @($miHeader, '-', $miOpen, $miStartStop, $miRestart, '-', $miLog, $miAuto, '-', $miQuit)) {
+  [void]$menu.MenuItems.Add($item)
+}
+$tray.ContextMenu = $menu
+
+function Set-State($s) {
+  if ($script:state -eq $s) { return }
+  $script:state = $s
+  $tray.Icon = $icons[$s]
+  $tray.Text = "Claude Code Hub: $s"
+  $miStartStop.Text = if ($s -eq 'stopped') { 'Start Hub' } else { 'Stop Hub' }
+  $miOpen.Enabled = $s -eq 'running'
+  $miRestart.Enabled = $s -ne 'stopped'
+}
+
+function Update-Header {
+  $dot = [char]0x00B7
+  $parts = @(if ($script:hub) { "Running on port $($script:hub.port)" } elseif ($script:state -eq 'starting') { 'Starting' } else { 'Stopped' })
+  $name = Get-ConfigDirName
+  if ($name) { $parts += $name }
+  $miHeader.Text = $parts -join "  $dot  "
+}
+
+# Stop-Hub clears hubProc, so a hubProc that has exited is a hub that died on its own.
+function Update-State {
+  $script:hub = Get-Hub
+  if ($script:hub) { Set-State 'running'; return }
+  if ($script:hubProc -and -not $script:hubProc.HasExited) { Set-State 'starting'; return }
+  if ($script:hubProc) {
+    $script:hubProc.Dispose()
+    $script:hubProc = $null
+    Write-TrayLog 'hub exited'
+    $tray.ShowBalloonTip(5000, 'Claude Code Hub', 'The hub stopped. Start it from the tray menu; see Open log.', 'Warning')
+  }
+  Set-State 'stopped'
+}
+
+$tray.add_MouseClick({ param($s, $e) if ($e.Button -eq 'Left') { Open-Hub } })
+$miOpen.add_Click({ Open-Hub })
+$miStartStop.add_Click({ if ($script:state -eq 'stopped') { Start-Hub } else { Stop-Hub; Update-State } })
+$miRestart.add_Click({ Stop-Hub; Start-Hub })
+$miLog.add_Click({ if (Test-Path $LogFile) { Start-Process $LogFile } })
+$menu.add_Popup({ $miAuto.Checked = Get-Autostart; Update-Header })
+$miAuto.add_Click({
+  if (Get-Autostart) { Remove-ItemProperty $RunKey -Name $config.runValue }
+  else { Set-ItemProperty $RunKey -Name $config.runValue -Value "wscript.exe `"$(Join-Path $TrayDir 'launch.vbs')`"" }
+})
+$miQuit.add_Click({
+  $timer.Stop()
+  Stop-Hub
+  Remove-Item $TrayPidFile -ErrorAction SilentlyContinue
+  $tray.Visible = $false
+  [System.Windows.Forms.Application]::Exit()
+})
+
+$timer = New-Object System.Windows.Forms.Timer
+$timer.Interval = 3000
+$timer.add_Tick({ try { Update-State } catch { Write-TrayLog "tick: $_" } })
+
+Set-State 'starting'
+$tray.Visible = $true
+try { Start-Hub } catch { Write-TrayLog "start failed: $_" }
+$timer.Start()
+[System.Windows.Forms.Application]::Run()
+$tray.Dispose()

package/tray/icon.ps1

@@ -0,0 +1,49 @@
+function New-RoundRect([float]$x, [float]$y, [float]$w, [float]$h, [float]$r) {
+  $p = New-Object System.Drawing.Drawing2D.GraphicsPath
+  $d = $r * 2
+  $p.AddArc($x, $y, $d, $d, 180, 90)
+  $p.AddArc($x + $w - $d, $y, $d, $d, 270, 90)
+  $p.AddArc($x + $w - $d, $y + $h - $d, $d, $d, 0, 90)
+  $p.AddArc($x, $y + $h - $d, $d, $d, 90, 90)
+  $p.CloseFigure()
+  $p
+}
+
+# public/icons/icon-192.svg redrawn at the tray's own size, with a status dot in place of the bottom-right tile.
+function New-TrayBitmap([int]$size, [System.Drawing.Color]$status) {
+  $k = $size / 192
+  $bmp = New-Object System.Drawing.Bitmap $size, $size
+  $g = [System.Drawing.Graphics]::FromImage($bmp)
+  $g.SmoothingMode = 'AntiAlias'
+  $g.PixelOffsetMode = 'Half'
+  $bg = New-Object System.Drawing.SolidBrush ([System.Drawing.Color]::FromArgb(26, 26, 46))
+  $path = New-RoundRect 0 0 $size $size (32 * $k)
+  $g.FillPath($bg, $path)
+  $path.Dispose()
+  # Whole-pixel tiles and stroke keep the outlines sharp at 16 px.
+  $stroke = [Math]::Max(1, [Math]::Round(6 * $k))
+  $tile = [Math]::Round(40 * $k)
+  $pen = New-Object System.Drawing.Pen ([System.Drawing.Color]::FromArgb(233, 69, 96)), $stroke
+  foreach ($pos in @(@(44, 44), @(108, 44), @(44, 108))) {
+    $x = [Math]::Round($pos[0] * $k) + $stroke / 2
+    $y = [Math]::Round($pos[1] * $k) + $stroke / 2
+    $path = New-RoundRect $x $y ($tile - $stroke) ($tile - $stroke) ([Math]::Max(0.5, 6 * $k))
+    $g.DrawPath($pen, $path)
+    $path.Dispose()
+  }
+  $c = 128 * $k
+  $dot = $size * 0.2
+  $brush = New-Object System.Drawing.SolidBrush $status
+  $g.FillEllipse($brush, $c - $dot, $c - $dot, 2 * $dot, 2 * $dot)
+  $brush.Dispose()
+  $pen.Dispose()
+  $bg.Dispose()
+  $g.Dispose()
+  $bmp
+}
+
+$StateColors = @{
+  running  = [System.Drawing.Color]::FromArgb(34, 197, 94)
+  starting = [System.Drawing.Color]::FromArgb(245, 158, 11)
+  stopped  = [System.Drawing.Color]::FromArgb(239, 68, 68)
+}

package/tray/launch.vbs

@@ -0,0 +1,4 @@
+' Starts the tray with no console window; powershell -WindowStyle Hidden still flashes one.
+Set fso = CreateObject("Scripting.FileSystemObject")
+dir = fso.GetParentFolderName(WScript.ScriptFullName)
+CreateObject("WScript.Shell").Run "powershell.exe -NoProfile -ExecutionPolicy Bypass -STA -WindowStyle Hidden -File """ & dir & "\hub-tray.ps1""", 0, False