claude-code-pulsify 1.1.0 → 1.1.1

package/README.md

@@ -34,6 +34,18 @@ npx claude-code-pulsify@latest --uninstall
 - **Context monitor** -- Warns at 65% and 75% context usage via PostToolUse hook
 - **Update checker** -- Background version check on session start, non-blocking
 
+## Checking your installed version
+
+```bash
+npx claude-code-pulsify --status
+```
+
+This shows the currently installed version, hooks location, and whether an update is available.
+
+You can also check manually:
+- **VERSION file:** `~/.claude/hooks/claude-code-pulsify/VERSION`
+- **Update cache:** `~/.claude/cache/claude-code-pulsify-update.json` — written on each session start, contains `installed`, `latest`, and `updateAvailable` fields
+
 ## Configuration
 
 Respects the `CLAUDE_CONFIG_DIR` environment variable. Defaults to `~/.claude`.

package/bin/install.js

@@ -69,9 +69,15 @@ function install() {
   fs.writeFileSync(path.join(hooksTarget, 'VERSION'), PACKAGE_VERSION, 'utf8')
   console.log(`  Wrote VERSION (${PACKAGE_VERSION})`)
 
-  // 3. Clear stale update cache so the indicator disappears immediately
-  const updateCachePath = path.join(configDir, 'cache', 'claude-code-pulsify-update.json')
-  try { fs.unlinkSync(updateCachePath) } catch { /* doesn't exist — fine */ }
+  // 3. Clear update cache so stale "update available" indicators don't persist after install.
+  //    The background worker will refresh it on next session.
+  const cachePath = path.join(configDir, 'cache', 'claude-code-pulsify-update.json')
+  try {
+    fs.unlinkSync(cachePath)
+    console.log(`  Cleared update cache`)
+  } catch {
+    // Doesn't exist — fine
+  }
 
   // 4. Patch settings.json
   const settings = readJSON(settingsPath)
@@ -170,6 +176,26 @@ const args = process.argv.slice(2)
 
 if (args.includes('--version')) {
   console.log(PACKAGE_VERSION)
+} else if (args.includes('--status')) {
+  const versionFile = path.join(hooksTarget, 'VERSION')
+  const cachePath = path.join(configDir, 'cache', 'claude-code-pulsify-update.json')
+  const installed = fs.existsSync(versionFile) ? fs.readFileSync(versionFile, 'utf8').trim() : null
+  if (!installed) {
+    console.log('claude-code-pulsify is not installed.')
+    process.exit(1)
+  }
+  console.log(`Installed: v${installed}`)
+  console.log(`Hooks:     ${hooksTarget}`)
+  try {
+    const cache = JSON.parse(fs.readFileSync(cachePath, 'utf8'))
+    if (cache.updateAvailable && cache.latest) {
+      console.log(`Latest:    v${cache.latest} (update available)`)
+    } else {
+      console.log(`Latest:    v${cache.latest || installed} (up to date)`)
+    }
+  } catch {
+    console.log(`Latest:    unknown (run a Claude Code session to check)`)
+  }
 } else if (args.includes('--uninstall')) {
   uninstall()
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-pulsify",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Context-aware statusline and context monitor for Claude Code",
   "bin": {
     "claude-code-pulsify": "bin/install.js"