embertime 0.1.1 → 0.1.3

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "ember",
   "description": "Ember coding-time tracker: records Claude Code sessions, prompts and file edits as anonymised Ember heartbeats (no prompt text, file contents or paths are sent).",
-  "version": "0.1.1"
+  "version": "0.1.3"
 }

package/README.md

@@ -5,7 +5,8 @@ Cursor Agent** with one command. Your time shows up on
 [Ember](https://ember-dev.vercel.app) as a yearly heatmap, language stats and a
 developer leaderboard.
 
-Ember records **when** and **in which project** you code. It never sends your
+Ember records **when** and **in which project** you write code. Only writing counts:
+an editor or agent that is just open adds no time. It never sends your
 code, file contents, file paths or AI prompts.
 
 ## Setup

package/cli.mjs

@@ -14,6 +14,7 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { apply, writeEmberConfig } from './install.mjs';
+import { EDITORS, findEditor, runEditor } from './editors.mjs';
 
 // Public server and Marketplace id. Change DEFAULT_API_URL before publishing.
 export const DEFAULT_API_URL = process.env.EMBER_DEFAULT_API_URL || 'https://ember-dev.vercel.app';
@@ -21,12 +22,6 @@ export const EXTENSION_ID = 'ember-dev.embertime';
 const KEY_RE = /^ember_[0-9a-f]{40}$/i;
 const HERE = path.dirname(fileURLToPath(import.meta.url));
 const PAYLOAD = ['ember-hook.mjs', 'install.mjs', 'package.json'];
-const EDITORS = [
-  { cli: 'code', name: 'VS Code' },
-  { cli: 'cursor', name: 'Cursor' },
-  { cli: 'windsurf', name: 'Windsurf' },
-  { cli: 'codium', name: 'VSCodium' },
-];
 
 const env = process.env;
 const home = () => env.HOME || os.homedir();
@@ -36,6 +31,11 @@ const c = process.stdout.isTTY && !env.NO_COLOR
   ? { ok: (s) => `\x1b[32m${s}\x1b[0m`, dim: (s) => `\x1b[2m${s}\x1b[0m`, warn: (s) => `\x1b[33m${s}\x1b[0m`, bold: (s) => `\x1b[1m${s}\x1b[0m` }
   : { ok: (s) => s, dim: (s) => s, warn: (s) => s, bold: (s) => s };
 
+/** Each installed editor with the command that launches it. */
+function installedEditors() {
+  return EDITORS.map((e) => ({ ...e, command: findEditor(e, { home: home(), localAppData: env.LOCALAPPDATA || '' }) })).filter((e) => e.command);
+}
+
 function onPath(cmd) {
   const r = spawnSync(process.platform === 'win32' ? 'where' : 'which', [cmd], { encoding: 'utf8' });
   return r.status === 0;
@@ -121,10 +121,14 @@ async function setup(o) {
   }
 
   if (!o.skipEditors) {
-    for (const e of EDITORS) {
-      if (!onPath(e.cli)) continue;
-      const r = spawnSync(e.cli, ['--install-extension', o.vsix || EXTENSION_ID, '--force'], { encoding: 'utf8' });
-      results.push([e.name, r.status === 0 ? 'extension installed' : `install failed: ${(r.stderr || r.stdout).trim().split('\n').pop()}`, r.status === 0]);
+    const editors = installedEditors();
+    for (const e of editors) {
+      const r = runEditor(e.command, ['--install-extension', o.vsix || EXTENSION_ID, '--force']);
+      const why = (r.stderr || r.stdout || r.error?.message || '').trim().split('\n').pop();
+      results.push([e.name, r.status === 0 ? 'extension installed (restart the editor)' : `install failed: ${why}`, r.status === 0]);
+    }
+    if (editors.length === 0) {
+      results.push(['Editors', 'none found. In VS Code, Cursor or Windsurf, open Extensions, search "embertime" and install it']);
     }
   }
 
@@ -136,28 +140,33 @@ async function setup(o) {
 
 async function status() {
   const cfg = readConfig();
-  console.log(`config   ${cfg.api_key ? `key …${cfg.api_key.slice(-4)}, server ${cfg.api_url}` : 'no key (run setup)'}`);
+  console.log(`${'Config'.padEnd(13)}${cfg.api_key ? `key …${cfg.api_key.slice(-4)}, server ${cfg.api_url}` : 'no key (run setup)'}`);
   for (const [label, file] of [
-    ['claude', path.join(home(), '.claude', 'settings.json')],
-    ['codex', path.join(env.CODEX_HOME || path.join(home(), '.codex'), 'hooks.json')],
-    ['cursor', path.join(home(), '.cursor', 'hooks.json')],
+    ['Claude Code', path.join(home(), '.claude', 'settings.json')],
+    ['Codex', path.join(env.CODEX_HOME || path.join(home(), '.codex'), 'hooks.json')],
+    ['Cursor Agent', path.join(home(), '.cursor', 'hooks.json')],
   ]) {
     let on = false;
     try { on = fs.readFileSync(file, 'utf8').includes('ember-hook.mjs'); } catch { /* missing */ }
-    console.log(`${label.padEnd(8)} ${on ? 'hooks installed' : 'not connected'}`);
+    console.log(`${label.padEnd(13)}${on ? 'hooks installed' : 'not connected'}`);
+  }
+  for (const e of installedEditors()) {
+    const r = runEditor(e.command, ['--list-extensions']);
+    const on = r.status === 0 && r.stdout.toLowerCase().split(/\r?\n/).includes(EXTENSION_ID);
+    console.log(`${e.name.padEnd(13)}${on ? 'extension installed' : 'extension missing (run setup)'}`);
   }
   const q = path.join(emberHome(), 'queue.jsonl');
   const queued = fs.existsSync(q) ? fs.readFileSync(q, 'utf8').split('\n').filter(Boolean).length : 0;
-  console.log(`queue    ${queued} heartbeat(s) waiting`);
+  console.log(`${'Queue'.padEnd(13)}${queued} heartbeat(s) waiting`);
   const err = path.join(emberHome(), 'last_error');
-  if (fs.existsSync(err)) console.log(`error    ${fs.readFileSync(err, 'utf8').trim()}`);
+  if (fs.existsSync(err)) console.log(`${'Last error'.padEnd(13)}${fs.readFileSync(err, 'utf8').trim()}`);
   if (cfg.api_key) {
     try {
       const res = await fetch(`${cfg.api_url}/api/v1/me/today`, { headers: { Authorization: `Bearer ${cfg.api_key}` }, signal: AbortSignal.timeout(6000) });
       const body = res.ok ? await res.json() : null;
-      console.log(`server   ${body ? `today ${body.text} as @${body.username}` : `HTTP ${res.status}`}`);
+      console.log(`${'Server'.padEnd(13)}${body ? `today ${body.text} as @${body.username}` : `HTTP ${res.status}`}`);
     } catch {
-      console.log('server   unreachable');
+      console.log(`${'Server'.padEnd(13)}unreachable`);
     }
   }
 }
@@ -171,7 +180,10 @@ function uninstall(o) {
       console.log(`${t.padEnd(8)} skipped: ${e.message}`);
     }
   }
-  for (const e of EDITORS) if (onPath(e.cli)) spawnSync(e.cli, ['--uninstall-extension', EXTENSION_ID], { stdio: 'ignore' });
+  for (const e of installedEditors()) {
+    const r = runEditor(e.command, ['--uninstall-extension', EXTENSION_ID]);
+    console.log(`${e.name.padEnd(13)}${r.status === 0 ? 'extension removed' : 'extension not installed'}`);
+  }
   if (o.purge) {
     fs.rmSync(emberHome(), { recursive: true, force: true });
     console.log(`removed  ${emberHome()}`);

package/editors.mjs

@@ -0,0 +1,50 @@
+// Finds the command-line launcher of each VS Code-family editor.
+//
+// Most people never run "Shell Command: Install 'code' command in PATH", so
+// looking only at PATH misses editors that are installed. When the command is
+// not on PATH we also look inside the usual install locations.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+
+export const EDITORS = [
+  { cli: 'code', name: 'VS Code', mac: 'Visual Studio Code.app', win: 'Microsoft VS Code', winBin: 'bin', linux: ['/usr/share/code/bin/code', '/snap/bin/code'] },
+  { cli: 'cursor', name: 'Cursor', mac: 'Cursor.app', win: 'cursor', winBin: 'resources/app/bin', linux: ['/usr/share/cursor/bin/cursor', '/opt/Cursor/resources/app/bin/cursor'] },
+  { cli: 'windsurf', name: 'Windsurf', mac: 'Windsurf.app', win: 'Windsurf', winBin: 'bin', linux: ['/usr/share/windsurf/bin/windsurf'] },
+  { cli: 'codium', name: 'VSCodium', mac: 'VSCodium.app', win: 'VSCodium', winBin: 'bin', linux: ['/usr/share/codium/bin/codium', '/snap/bin/codium'] },
+];
+
+function onPath(cmd, platform) {
+  const r = spawnSync(platform === 'win32' ? 'where' : 'which', [cmd], { encoding: 'utf8' });
+  return r.status === 0;
+}
+
+/** Install locations to try for one editor, most likely first. */
+export function candidates(editor, { platform = process.platform, home = '', localAppData = '' } = {}) {
+  if (platform === 'darwin') {
+    const bin = path.posix.join('Contents/Resources/app/bin', editor.cli);
+    return ['/Applications', path.posix.join(home, 'Applications')].map((dir) => path.posix.join(dir, editor.mac, bin));
+  }
+  if (platform === 'win32') {
+    if (!localAppData) return [];
+    return [path.win32.join(localAppData, 'Programs', editor.win, ...editor.winBin.split('/'), `${editor.cli}.cmd`)];
+  }
+  return editor.linux;
+}
+
+/**
+ * The command to run for an editor: its PATH name, the full path of an
+ * installed copy, or null when the editor isn't installed.
+ */
+export function findEditor(editor, { platform = process.platform, home = '', localAppData = '', exists = fs.existsSync, which = onPath } = {}) {
+  if (which(editor.cli, platform)) return editor.cli;
+  return candidates(editor, { platform, home, localAppData }).find((p) => exists(p)) ?? null;
+}
+
+/** Runs an editor's CLI. Windows launchers are .cmd files, which need a shell. */
+export function runEditor(command, args) {
+  if (process.platform !== 'win32') return spawnSync(command, args, { encoding: 'utf8' });
+  const quote = (s) => (/[\s"]/.test(s) ? `"${s.replace(/"/g, '\\"')}"` : s);
+  return spawnSync([command, ...args].map(quote).join(' '), { encoding: 'utf8', shell: true });
+}

package/ember-hook.mjs

@@ -21,7 +21,7 @@ import path from 'node:path';
 import crypto from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 
-export const VERSION = '0.1.1';
+export const VERSION = '0.1.3';
 export const AGENTS = ['claude-code', 'codex', 'cursor-agent'];
 
 /** Events whose heartbeats are throttled: they fire on every tool call or file edit. */
@@ -759,6 +759,15 @@ export async function runHook({ argv = [], env = process.env, stdinText = '' } =
     const payload = parsePayload(stdinText);
     const event = typeof payload.hook_event_name === 'string' ? payload.hook_event_name : '';
     const hb = buildHeartbeat(payload, { agent, env });
+    const { apiUrl, apiKey } = loadConfig(home, env);
+
+    // Only an agent changing a file counts as coding. Opening a session,
+    // sending a prompt or reading files does not; those events just deliver
+    // anything still queued.
+    if (!hb.is_write) {
+      await flushQueue(home, { apiUrl, apiKey });
+      return { status: 'not-writing' };
+    }
 
     const state = readState(home);
     if (shouldThrottle(state, hb, event)) return { status: 'throttled' };
@@ -766,7 +775,6 @@ export async function runHook({ argv = [], env = process.env, stdinText = '' } =
     writeState(home, state);
 
     appendToQueue(home, hb);
-    const { apiUrl, apiKey } = loadConfig(home, env);
     return await flushQueue(home, { apiUrl, apiKey });
   } catch (e) {
     log(home, 'error', `hook failed: ${e?.stack || e}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "embertime",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Connect VS Code, Cursor, Windsurf, Claude Code and Codex to Ember in one command. Tracks coding time, never code or prompts.",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "cli.mjs",
+    "editors.mjs",
     "ember-hook.mjs",
     "install.mjs",
     "hooks",