pulse-for-claude-code 0.1.0

package/src/config.js

@@ -0,0 +1,83 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// API list prices per 1M tokens (USD). Used only to estimate an
+// "API-equivalent" cost for subscription users, who do not pay per token.
+// Override any of these in ~/.claude-pulse.json -> "pricing".
+const PRICING = {
+  opus:    { in: 15, out: 75, cacheWrite: 18.75, cacheRead: 1.5 },
+  sonnet:  { in: 3,  out: 15, cacheWrite: 3.75,  cacheRead: 0.3 },
+  haiku:   { in: 1,  out: 5,  cacheWrite: 1.25,  cacheRead: 0.1 },
+  default: { in: 3,  out: 15, cacheWrite: 3.75,  cacheRead: 0.3 },
+};
+
+// Anthropic does not publish exact subscription limits, and they are usage
+// based rather than a hard token number. These are rough API-equivalent
+// budgets (USD) per rolling window, meant as a starting point. Edit them in
+// ~/.claude-pulse.json -> "budgets" to match what you actually observe.
+const PLAN_BUDGETS = {
+  pro:    { fiveHour: 8,   day: 20,  week: 60 },
+  max5:   { fiveHour: 35,  day: 90,  week: 280 },
+  max20:  { fiveHour: 140, day: 360, week: 1100 },
+  custom: { fiveHour: null, day: null, week: null },
+};
+
+function priceFor(model, pricing) {
+  const p = pricing || PRICING;
+  const m = String(model || '').toLowerCase();
+  if (m.includes('opus')) return p.opus;
+  if (m.includes('sonnet')) return p.sonnet;
+  if (m.includes('haiku')) return p.haiku;
+  return p.default;
+}
+
+function configPath() {
+  return path.join(os.homedir(), '.claude-pulse.json');
+}
+
+function loadConfig() {
+  const defaults = {
+    plan: 'unknown',      // we cannot detect the real plan, so never claim one
+    contextLimit: 200000, // Opus/Sonnet default; 1M is auto-detected per session
+    idleMinutes: 10,      // a session is "active" if it moved within this window
+    pricing: PRICING,
+    budgets: null,        // filled from the plan preset unless set explicitly
+    ntfyTopic: '',        // ntfy.sh topic for phone push; empty = off
+    bindLan: false,       // listen on the LAN so a phone on Wi-Fi can approve
+    lanUrl: '',           // e.g. http://192.168.1.20:4317 ; enables phone Allow buttons
+    approvalTimeoutMs: 60000, // how long the Allow hook waits for you before the normal prompt
+    snapshotMinutes: 15,  // auto-save a light export of active sessions this often (0 = off)
+  };
+
+  let user = {};
+  try {
+    user = JSON.parse(fs.readFileSync(configPath(), 'utf8'));
+  } catch (e) {
+    // no user config yet, defaults are fine
+  }
+
+  const cfg = Object.assign({}, defaults, user);
+  cfg.pricing = Object.assign({}, PRICING, user.pricing || {});
+  // Budgets are opt-in only. We never derive a USD budget from the plan: real
+  // subscription limits are not exposed by Anthropic, and the API-equivalent
+  // cost dwarfs any small preset, which produced nonsense like "2232% of limit".
+  cfg.budgets = user.budgets || { fiveHour: null, day: null, week: null };
+  // if the user pinned contextLimit explicitly, never auto-bump it to 1M
+  cfg.contextLimitExplicit = Object.prototype.hasOwnProperty.call(user, 'contextLimit');
+  return cfg;
+}
+
+function saveConfig(partial) {
+  let cur = {};
+  try { cur = JSON.parse(fs.readFileSync(configPath(), 'utf8')); } catch (e) {}
+  const next = Object.assign({}, cur, partial || {});
+  // when the plan changes, drop stale explicit budgets so the preset applies
+  if (partial && partial.plan && !partial.budgets) delete next.budgets;
+  fs.writeFileSync(configPath(), JSON.stringify(next, null, 2));
+  return loadConfig();
+}
+
+module.exports = { loadConfig, saveConfig, priceFor, PRICING, PLAN_BUDGETS, configPath };

package/src/daemon.js

@@ -0,0 +1,148 @@
+'use strict';
+
+// Run Pulse detached from the terminal that started it, so closing or crashing
+// that terminal does not take Pulse down. start() spawns the server in its own
+// process group and records the pid; the parent command returns immediately.
+// On macOS, installService() goes further and hands Pulse to launchd, which
+// starts it at login and respawns it if it ever dies.
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawn, execFileSync } = require('child_process');
+
+const STATE_DIR = path.join(os.homedir(), '.claude-pulse');
+const PID_FILE = path.join(STATE_DIR, 'pulse.pid');
+const LOG_FILE = path.join(STATE_DIR, 'pulse.log');
+const CLI = path.join(__dirname, '..', 'bin', 'cli.js');
+const PLIST_LABEL = 'com.claude-pulse';
+const PLIST_PATH = path.join(os.homedir(), 'Library', 'LaunchAgents', PLIST_LABEL + '.plist');
+
+function ensureDir() { try { fs.mkdirSync(STATE_DIR, { recursive: true }); } catch (e) {} }
+
+function readState() {
+  try { return JSON.parse(fs.readFileSync(PID_FILE, 'utf8')); } catch (e) { return null; }
+}
+
+function isAlive(pid) {
+  if (!pid) return false;
+  try { process.kill(pid, 0); return true; } catch (e) { return e.code === 'EPERM'; }
+}
+
+function running() {
+  const s = readState();
+  return s && isAlive(s.pid) ? s : null;
+}
+
+function start(opts = {}) {
+  ensureDir();
+  const cur = running();
+  if (cur) {
+    console.log(`already running (pid ${cur.pid}) at http://127.0.0.1:${cur.port}`);
+    return cur;
+  }
+  const port = opts.port || 4317;
+  const out = fs.openSync(LOG_FILE, 'a');
+  const child = spawn(process.execPath, [CLI, 'run', '--no-open', '--port', String(port)], {
+    detached: true,
+    stdio: ['ignore', out, out],
+  });
+  child.unref();
+  const state = { pid: child.pid, port, startedAt: new Date().toISOString() };
+  fs.writeFileSync(PID_FILE, JSON.stringify(state));
+  console.log(`Pulse started in the background (pid ${child.pid})`);
+  console.log(`  http://127.0.0.1:${port}`);
+  console.log(`  it keeps running after you close this terminal`);
+  console.log(`  stop:   claude-pulse stop`);
+  console.log(`  status: claude-pulse status`);
+  console.log(`  log:    ${LOG_FILE}`);
+  return state;
+}
+
+function stop() {
+  const s = readState();
+  if (!s || !isAlive(s.pid)) {
+    console.log('not running');
+    try { fs.unlinkSync(PID_FILE); } catch (e) {}
+    return;
+  }
+  try { process.kill(s.pid, 'SIGTERM'); } catch (e) {}
+  try { fs.unlinkSync(PID_FILE); } catch (e) {}
+  console.log(`stopped (pid ${s.pid})`);
+}
+
+function restart(opts) {
+  stop();
+  return start(opts);
+}
+
+function status() {
+  const s = running();
+  if (s) {
+    console.log(`running (pid ${s.pid}) at http://127.0.0.1:${s.port}`);
+    console.log(`  since ${s.startedAt}`);
+  } else if (fs.existsSync(PLIST_PATH)) {
+    console.log('not in the pid file, but a launch agent is installed (launchd manages it).');
+    console.log('  check: launchctl list | grep claude-pulse');
+  } else {
+    console.log('not running. start with: claude-pulse start');
+  }
+}
+
+function installService(opts = {}) {
+  if (process.platform !== 'darwin') {
+    console.log('install-service is macOS only. on this OS use: claude-pulse start');
+    return;
+  }
+  ensureDir();
+  const port = opts.port || 4317;
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${PLIST_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${process.execPath}</string>
+    <string>${CLI}</string>
+    <string>run</string>
+    <string>--no-open</string>
+    <string>--port</string>
+    <string>${port}</string>
+  </array>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>${LOG_FILE}</string>
+  <key>StandardErrorPath</key><string>${LOG_FILE}</string>
+</dict>
+</plist>
+`;
+  // a manual background instance would hold the port, so retire it first
+  stop();
+  try { fs.mkdirSync(path.dirname(PLIST_PATH), { recursive: true }); } catch (e) {}
+  fs.writeFileSync(PLIST_PATH, plist);
+  try { execFileSync('launchctl', ['unload', PLIST_PATH], { stdio: 'ignore' }); } catch (e) {}
+  try {
+    execFileSync('launchctl', ['load', '-w', PLIST_PATH], { stdio: 'ignore' });
+  } catch (e) {
+    console.error('could not load the launch agent:', e && e.message);
+    return;
+  }
+  console.log(`installed launch agent "${PLIST_LABEL}"`);
+  console.log(`  Pulse now starts at login and respawns itself if it ever dies`);
+  console.log(`  http://127.0.0.1:${port}`);
+  console.log(`  remove with: claude-pulse uninstall-service`);
+}
+
+function uninstallService() {
+  if (process.platform !== 'darwin') { console.log('nothing to remove on this OS'); return; }
+  try { execFileSync('launchctl', ['unload', '-w', PLIST_PATH], { stdio: 'ignore' }); } catch (e) {}
+  try {
+    fs.unlinkSync(PLIST_PATH);
+    console.log('removed launch agent. Pulse will no longer start at login.');
+  } catch (e) {
+    console.log('no launch agent was installed');
+  }
+}
+
+module.exports = { start, stop, restart, status, installService, uninstallService, running };