clauddy 1.27.0 → 1.28.0

package/renderer/pet.js

@@ -148,6 +148,8 @@ function fmtReset(ms) {
 function fmtResetClock(ms) {
   if (!ms || ms <= 0) return null
   const at = new Date(Date.now() + ms)
+  // a week or more out (Cursor's month), a weekday would be ambiguous
+  if (ms >= 6 * 86400000) return at.toLocaleDateString([], { month: 'short', day: 'numeric' })
   const time = at.toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' })
   return ms >= 86400000 ? `${at.toLocaleDateString([], { weekday: 'short' })} ${time}` : time
 }
@@ -603,33 +605,35 @@ function takeRecap(was) {
   return r
 }
 
-// Codex, followed whichever tab is on screen. Its logs only move while it
-// runs, so a stale reading keeps the baseline: the next fresh one is compared
-// against the last number actually seen.
-let lastCodexPct = null
-function listenCodex() {
-  const c = codexData
-  if (!codexOn() || !c) {
-    lastCodexPct = null
+// Codex and Cursor, followed whichever tab is on screen. Codex's logs only move
+// while it runs, so a stale reading keeps the baseline: the next fresh one is
+// compared against the last number actually seen.
+const lastExtPct = { codex: null, cursor: null }
+function listenExt(p) {
+  const c = dataOf(p)
+  if (!isOn(p) || !c) {
+    lastExtPct[p] = null
     return
   }
   const pct = c.session?.pct
-  if (pct == null || codexStale(c)) return
-  const was = lastCodexPct
-  lastCodexPct = pct
+  if (pct == null || readingStale(c)) return
+  const was = lastExtPct[p]
+  lastExtPct[p] = pct
   if (was == null) return
   const fireAt = currentConfig.fireThreshold ?? 90
   const reset = c.session.resetMs
-  if (was - pct > 25) say(Voice.codexResetLine(was), { headline: true })
+  const name = NAMES[p]
+  if (was - pct > 25)
+    say(Voice.codexResetLine(was, name, p === 'cursor' ? 'month' : 'window'), { headline: true })
   else if (was < 100 && pct >= 100)
-    say(Voice.codexMaxedLine(fmtResetClock(reset)), { mood: 'sleepy' })
+    say(Voice.codexMaxedLine(fmtResetClock(reset), name), { mood: 'sleepy' })
   else if (was < fireAt && pct >= fireAt && pct < 100)
-    say(Voice.codexFireLine(pct, reset, fmtReset), { headline: true, mood: 'fire' })
+    say(Voice.codexFireLine(pct, reset, fmtReset, name), { headline: true, mood: 'fire' })
 }
 
 // called by paint() with the state it just drew. The Claude remarks follow the
-// Claude view; Codex has its own, above.
-function listen(before, st, { isCodex, liveOn, sp, sessReset, proj }) {
+// Claude view; Codex and Cursor have their own, above.
+function listen(before, st, { isExt, liveOn, sp, sessReset, proj }) {
   // the saved config decides whether it talks at all, and it lands just after
   // the first usage tick: speaking before it would ignore a "talk: false"
   if (!heardConfig) return
@@ -643,8 +647,9 @@ function listen(before, st, { isCodex, liveOn, sp, sessReset, proj }) {
       if (say(line, { headline: true, mood })) return
     }
   }
-  listenCodex()
-  if (isCodex) return
+  listenExt('codex')
+  listenExt('cursor')
+  if (isExt) return
   const now = Date.now()
 
   if (liveOn) {
@@ -701,6 +706,8 @@ function sampleLine(kind) {
   }
   if (kind === 'codex')
     return Voice.codexFireLine(91, codexData?.session?.resetMs ?? reset, fmtReset)
+  if (kind === 'cursor')
+    return Voice.codexFireLine(91, cursorData?.session?.resetMs ?? reset, fmtReset, 'Cursor')
   if (kind === 'maxed') return Voice.maxedLine(fmtResetClock(reset))
   if (kind === 'welcome') return Voice.welcomeLine(3 * 3600000 + 12 * 60000, pct ?? null, fmtReset)
   if (kind === 'streak') return Voice.streakLine(95 * 60000, fmtReset)
@@ -714,7 +721,11 @@ function sampleLine(kind) {
 function sayDebug(kind) {
   const st = [...document.body.classList].find((c) => c.startsWith('state-'))?.slice(6)
   const mood =
-    kind === 'fire' || kind === 'codex' ? 'fire' : kind === 'maxed' ? 'sleepy' : moodOf(st)
+    kind === 'fire' || kind === 'codex' || kind === 'cursor'
+      ? 'fire'
+      : kind === 'maxed'
+        ? 'sleepy'
+        : moodOf(st)
   return say(sampleLine(kind), { force: true, mood })
 }
 
@@ -742,14 +753,18 @@ el('mute').addEventListener('click', (e) => {
 })
 
 // ---- services ---------------------------------------------------------------
-// Claude and Codex are monitored side by side, but the panel shows one at a
-// time: tabs own the chip, meters, breakdowns and Usage arrow. The expanded
-// scene follows that view; compact pets follow activity across both services.
+// Claude, Codex and Cursor are monitored side by side, but the panel shows one
+// at a time: tabs own the chip, meters, breakdowns and Usage arrow. The expanded
+// scene follows that view; compact pets follow activity across every service.
 const PROVIDER_KEY = 'clauddy.provider'
+const PROVIDERS = ['claude', 'codex', 'cursor']
+const NAMES = { claude: 'Claude', codex: 'Codex', cursor: 'Cursor' }
 let codexData = null // last Codex payload; null while Codex isn't enabled
+let cursorData = null // last Cursor payload; null while Cursor isn't enabled
 let pickedProvider = (() => {
   try {
-    return localStorage.getItem(PROVIDER_KEY) === 'codex' ? 'codex' : 'claude'
+    const p = localStorage.getItem(PROVIDER_KEY)
+    return PROVIDERS.includes(p) ? p : 'claude'
   } catch {
     return 'claude'
   }
@@ -757,12 +772,19 @@ let pickedProvider = (() => {
 
 const claudeOn = () => document.body.classList.contains('auth-on')
 const codexOn = () => !!currentConfig.codex
-const bothOn = () => claudeOn() && codexOn()
+const cursorOn = () => !!currentConfig.cursor
+const isOn = (p) => (p === 'claude' ? claudeOn() : p === 'codex' ? codexOn() : cursorOn())
+const connected = () => PROVIDERS.filter(isOn)
+// Codex and Cursor payloads; Claude's live in lastData + realUsage
+const dataOf = (p) => (p === 'codex' ? codexData : p === 'cursor' ? cursorData : null)
+// each service's two meters: the window that resets, and the one beside it
+const sessionOf = (p) => (p === 'claude' ? realUsage?.session : dataOf(p)?.session)
+const secondOf = (p) =>
+  p === 'claude' ? realUsage?.week : p === 'codex' ? codexData?.weekly : cursorData?.api
 // the service on screen: the pick, unless that one isn't there any more
 function viewProvider() {
-  if (!codexOn()) return 'claude'
-  if (!claudeOn()) return 'codex'
-  return pickedProvider
+  const on = connected()
+  return on.includes(pickedProvider) ? pickedProvider : on[0] || 'claude'
 }
 
 function pickProvider(p) {
@@ -776,31 +798,31 @@ function pickProvider(p) {
 
 const STALE_MS = 15 * 60000
 const CODEX_SLEEP_MS = 5 * 60000 // main's default sleepThresholdMs
-// Codex logs are only written while it runs, so a reading can be hours old
-const codexStale = (c) =>
+// Codex logs are only written while it runs, so a reading can be hours old;
+// Cursor's comes from a fetch that can fail. Either way: say how old it is.
+const readingStale = (c) =>
   !!c && (c.session?.expired || (c.limitsAt != null && Date.now() - c.limitsAt > STALE_MS))
 
 // the highest session % across connected services, and which ones are at or
-// past `from`; an expired Codex reading is null, so it never counts
+// past `from`; an expired Codex or Cursor reading is null, so it never counts
 function sessionHeat(from) {
-  const pcts = {
-    claude: claudeOn() ? realUsage?.session?.pct : null,
-    codex: codexOn() ? codexData?.session?.pct : null,
-  }
-  const known = Object.entries(pcts).filter(([, p]) => p != null)
+  const known = connected()
+    .map((p) => [p, sessionOf(p)?.pct])
+    .filter(([, pct]) => pct != null)
   return {
-    pct: Math.max(0, ...known.map(([, p]) => p)),
-    providers: known.filter(([, p]) => p >= from).map(([k]) => k),
+    pct: Math.max(0, ...known.map(([, pct]) => pct)),
+    providers: known.filter(([, pct]) => pct >= from).map(([p]) => p),
   }
 }
 
-// Codex's numbers in the shape the panel draws; its logs have no activity or tok/min
-function codexView(c) {
+// Codex's or Cursor's numbers in the shape the panel draws. Codex's logs carry
+// tokens but no activity; Cursor's transcripts carry activity but no tokens.
+function extView(p, c) {
   const idleFor = c.lastSeen ? Date.now() - c.lastSeen : null
   return {
     d: {
       active: c.active,
-      activity: null,
+      activity: p === 'cursor' ? c.activity : null,
       // no data is not the same as asleep
       sleeping: !c.active && idleFor != null && idleFor >= CODEX_SLEEP_MS,
       tokensPerMin: 0,
@@ -813,82 +835,83 @@ function codexView(c) {
       monthTokens: c.monthTokens ?? null,
     },
     sess: c.session,
-    week: c.weekly,
+    week: p === 'cursor' ? c.api : c.weekly,
     stale: c.limitsAt != null && Date.now() - c.limitsAt > STALE_MS ? c.limitsAt : null,
   }
 }
 
-// a Codex meter caption: its reset, or how old the reading is when that's what matters
-function codexSub(w, tokens, stale) {
-  const t = `${fmtTokens(tokens)} tokens`
-  if (!w) return `limits not recorded yet · ${t}`
-  if (w.pct == null) return `waiting for a fresh reading · ${t}`
+// a Codex or Cursor meter caption: its reset, or how old the reading is when
+// that's what matters. Cursor has no token counts, so `tokens` is null there.
+function extSub(w, tokens, stale, empty = 'limits not recorded yet') {
+  const t = tokens == null ? '' : `${fmtTokens(tokens)} tokens`
+  const join = (...parts) => parts.filter(Boolean).join(' · ')
+  if (!w) return join(empty, t)
+  if (w.pct == null) return join('waiting for a fresh reading', t)
   if (stale) {
-    const at = w.resetMs != null ? `resets ${fmtResetClock(w.resetMs)} · ` : ''
-    return `${at}read ${fmtReset(Date.now() - stale)} ago`
+    const at = w.resetMs != null ? `resets ${fmtResetClock(w.resetMs)}` : ''
+    return join(at, `read ${fmtReset(Date.now() - stale)} ago`)
   }
-  const reset = w.resetMs != null ? `resets in ${fmtResetIn(w.resetMs)} · ` : ''
-  return `${reset}${t}`
+  return join(w.resetMs != null ? `resets in ${fmtResetIn(w.resetMs)}` : '', t) || '—'
 }
 
 const pctText = (v) => (v == null ? '—' : `${Math.round(v)}%`)
 const warnAt = () => Math.min(...(currentConfig.alertThresholds || [80, 95]))
 
-// tabs + the collapsed pair: both services' session %, whichever is on screen
+// tabs + the collapsed dock: every service's session %, whichever is on screen
 function paintServices(view) {
-  const dual = bothOn()
-  document.body.classList.toggle('dual', dual)
-  document.body.classList.toggle('view-codex', view === 'codex')
-  // collapsed with both: when the selected service's session resets
-  const resetMs = view === 'codex' ? codexData?.session?.resetMs : realUsage?.session?.resetMs
-  el('mini-reset').hidden = !dual || resetMs == null
+  const on = connected()
+  const many = on.length > 1
+  document.body.classList.toggle('dual', many)
+  document.body.classList.toggle('trio', on.length > 2)
+  for (const p of ['codex', 'cursor']) document.body.classList.toggle(`view-${p}`, view === p)
+  // collapsed with several: when the selected service's window resets
+  const resetMs = sessionOf(view)?.resetMs
+  el('mini-reset').hidden = !many || resetMs == null
   el('mini-reset').textContent = resetMs == null ? '' : `resets ${fmtResetClock(resetMs)}`
-  el('service-panel').setAttribute('role', dual ? 'tabpanel' : 'region')
-  if (dual) {
+  el('service-panel').setAttribute('role', many ? 'tabpanel' : 'region')
+  if (many) {
     el('service-panel').setAttribute('aria-labelledby', `tab-${view}`)
     el('service-panel').removeAttribute('aria-label')
   } else {
     el('service-panel').removeAttribute('aria-labelledby')
-    el('service-panel').setAttribute('aria-label', `${view === 'codex' ? 'Codex' : 'Claude'} usage`)
+    el('service-panel').setAttribute('aria-label', `${NAMES[view]} usage`)
     return
   }
-  const cl = realUsage
-  const cx = codexData
-  const rows = {
-    claude: {
-      pct: cl?.session?.pct ?? null,
-      week: cl?.week?.pct ?? null,
-      active: !!lastData?.active,
-    },
-    codex: {
-      pct: cx?.session?.pct ?? null,
-      week: cx?.weekly?.pct ?? null,
-      active: !!cx?.active,
-      stale: codexStale(cx),
-    },
+  // what each service calls its two meters
+  const labels = {
+    claude: ['session', 'weekly'],
+    codex: ['session', 'weekly'],
+    cursor: ['month', 'API'],
   }
-  for (const [p, r] of Object.entries(rows)) {
-    const on = p === view
-    const urgent = Math.max(r.pct ?? 0, r.week ?? 0) >= warnAt()
+  for (const p of PROVIDERS) {
     const tab = el(`tab-${p}`)
-    tab.setAttribute('aria-selected', String(on))
-    tab.tabIndex = on ? 0 : -1
-    tab.classList.toggle('active', r.active)
+    const line = document.querySelector(`.mini-source[data-provider="${p}"]`)
+    tab.hidden = !on.includes(p)
+    line.hidden = tab.hidden
+    if (tab.hidden) continue
+    const pct = sessionOf(p)?.pct ?? null
+    const second = secondOf(p)?.pct ?? null
+    const active = p === 'claude' ? !!lastData?.active : !!dataOf(p)?.active
+    const stale = p !== 'claude' && readingStale(dataOf(p))
+    const selected = p === view
+    const urgent = Math.max(pct ?? 0, second ?? 0) >= warnAt()
+    tab.setAttribute('aria-selected', String(selected))
+    tab.tabIndex = selected ? 0 : -1
+    tab.classList.toggle('active', active)
     tab.classList.toggle('urgent', urgent)
     tab.querySelector('.tab-alert').hidden = !urgent
-    el(`tab-${p}-value`).textContent = pctText(r.pct)
-    const name = p === 'claude' ? 'Claude' : 'Codex'
-    tab.title = `${name} session ${pctText(r.pct)} · weekly ${pctText(r.week)}${r.active ? ' · working' : ''}${r.stale ? ' · not updated recently' : ''}`
-    const line = document.querySelector(`.mini-source[data-provider="${p}"]`)
-    line.setAttribute('aria-pressed', String(on))
+    el(`tab-${p}-value`).textContent = pctText(pct)
+    const [first, next] = labels[p]
+    tab.title = `${NAMES[p]} ${first} ${pctText(pct)} · ${next} ${pctText(second)}${active ? ' · working' : ''}${stale ? ' · not updated recently' : ''}`
+    line.setAttribute('aria-pressed', String(selected))
     line.title = tab.title
     line.setAttribute('aria-label', `Show ${tab.title}`)
     line.classList.toggle('urgent', urgent)
     tab.setAttribute('aria-label', `Show ${tab.title}`)
-    el(`mini-${p}-value`).textContent = pctText(r.pct)
+    el(`mini-${p}-value`).textContent = pctText(pct)
     const bar = el(`mini-${p}-bar`)
-    bar.style.width = `${Math.min(r.pct ?? 0, 100)}%`
-    bar.classList.toggle('hot', (r.pct ?? 0) >= 80)
+    bar.style.width = `${Math.min(pct ?? 0, 100)}%`
+    bar.classList.toggle('hot', (pct ?? 0) >= 80)
   }
 }
 
@@ -899,7 +922,7 @@ for (const b of document.querySelectorAll('#harness-tabs button, .mini-source'))
   })
 }
 el('harness-tabs').addEventListener('keydown', (e) => {
-  const providers = ['claude', 'codex']
+  const providers = connected()
   const current = providers.indexOf(e.target.dataset.provider)
   if (current < 0) return
   let next
@@ -919,7 +942,7 @@ let sizeLoaded = false
 let peekTimer = null
 let nativePetInside = null
 let noticeTimer = null
-let reminders = { claude: null, codex: null }
+let reminders = { claude: null, codex: null, cursor: null }
 const activityTracker = Companion.createActivityTracker()
 
 function setPetPeek(on) {
@@ -994,37 +1017,44 @@ for (const button of document.querySelectorAll('#pet-glance button[data-provider
   button.addEventListener('click', () => pickProvider(button.dataset.provider))
 }
 function paintCompanion(view) {
-  for (const provider of ['claude', 'codex']) {
-    const connected = provider === 'claude' ? claudeOn() : codexOn()
-    const session = provider === 'claude' ? realUsage?.session : codexData?.session
+  for (const provider of PROVIDERS) {
+    const session = sessionOf(provider)
     const button = el(`glance-${provider}`)
-    button.hidden = !connected
+    button.hidden = !isOn(provider)
     button.setAttribute('aria-pressed', String(provider === view))
     button.classList.toggle('urgent', session?.pct >= warnAt())
     el(`glance-${provider}-value`).textContent = pctText(session?.pct)
-    const stale = provider === 'codex' && codexStale(codexData)
+    const stale = provider !== 'claude' && readingStale(dataOf(provider))
     button.title = stale
       ? 'Last recorded usage · waiting for a fresh reading'
       : `Show ${provider} usage`
     button.classList.toggle('stale-reading', !!stale)
   }
-  el('glance-empty').hidden = claudeOn() || codexOn()
-  const session = view === 'claude' ? realUsage?.session : codexData?.session
+  el('glance-empty').hidden = connected().length > 0
+  const session = sessionOf(view)
   const reminder = reminders[view]
+  const ext = dataOf(view)
   const stale =
-    view === 'codex'
-      ? !codexData?.limitsAt || codexStale(codexData)
-      : !realUsageReadAt || Date.now() - realUsageReadAt > STALE_MS
+    view === 'claude'
+      ? !realUsageReadAt || Date.now() - realUsageReadAt > STALE_MS
+      : !ext?.limitsAt || readingStale(ext)
   const available = session?.pct != null && session.resetMs > 0 && !stale
-  const name = view === 'codex' ? 'Codex' : 'Claude'
+  const name = NAMES[view]
   for (const id of ['reminder-toggle', 'mini-reminder']) {
     const button = el(id)
     button.hidden = !reminder && (!available || session.pct < warnAt())
     button.setAttribute('aria-pressed', String(!!reminder))
     button.textContent = reminder ? '✓ Reminder on' : 'Notify at reset'
+    const at = reminder ? new Date(reminder.at) : null
+    // a month-out reset needs its date, not just a time
+    const when = at
+      ? at.getTime() - Date.now() >= 86400000
+        ? at.toLocaleDateString([], { month: 'short', day: 'numeric' })
+        : at.toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' })
+      : ''
     button.title = reminder
-      ? `Cancel ${name} reminder for ${new Date(reminder.at).toLocaleTimeString([], { hour: 'numeric', minute: '2-digit' })}`
-      : `Remind me when ${name}'s session reset is due`
+      ? `Cancel ${name} reminder for ${when}`
+      : `Remind me when ${name}'s ${view === 'cursor' ? 'monthly' : 'session'} reset is due`
   }
 }
 function companionNotice(text, provider = null) {
@@ -1047,14 +1077,14 @@ for (const id of ['reminder-toggle', 'mini-reminder']) {
   })
 }
 window.api.onReminders((state) => {
-  reminders = state || { claude: null, codex: null }
+  reminders = state || { claude: null, codex: null, cursor: null }
   if (state?.error) companionNotice(state.error)
   paintCompanion(viewProvider())
   fitSize()
 })
 window.api.onReminderDue((event) => {
   if (!event.isCurrent) return
-  const name = event.provider === 'codex' ? 'Codex' : 'Claude'
+  const name = NAMES[event.provider] || 'Claude'
   companionNotice(
     event.confirmed ? `${name} · budget is back!` : `${name} · reset time reached`,
     event.provider,
@@ -1066,13 +1096,14 @@ function reactToProvider(provider, data) {
   const cue = activityTracker.observe(provider, data)
   if (!cue || document.body.classList.contains('settings-open')) return
   if (!window.matchMedia?.('(prefers-reduced-motion: reduce)').matches) {
-    const x = provider === 'codex' ? 3 : -3
+    // in tab order: Claude to the left, Codex to the right, Cursor down-right
+    const [x, y] = { claude: [-3, 0], codex: [3, 0], cursor: [3, 1] }[provider] || [0, 0]
     el('eyes').animate(
       [
-        { transform: 'translateX(0)' },
-        { transform: `translateX(${x}px)`, offset: 0.3 },
-        { transform: `translateX(${x}px)`, offset: 0.7 },
-        { transform: 'translateX(0)' },
+        { transform: 'translate(0, 0)' },
+        { transform: `translate(${x}px, ${y}px)`, offset: 0.3 },
+        { transform: `translate(${x}px, ${y}px)`, offset: 0.7 },
+        { transform: 'translate(0, 0)' },
       ],
       { duration: 1100, easing: 'ease-in-out' },
     )
@@ -1080,17 +1111,18 @@ function reactToProvider(provider, data) {
 }
 
 function paintActivity() {
-  const activity = Companion.currentActivity(
-    claudeOn() ? claudeActivityData : null,
-    codexOn() ? codexData : null,
-  )
+  const activity = Companion.currentActivity({
+    claude: claudeOn() ? claudeActivityData : null,
+    codex: codexOn() ? codexData : null,
+    cursor: cursorOn() ? cursorData : null,
+  })
   paintLogos(activity.providers, activity.activity)
   return activity
 }
 
 // the logos under the pet name who it's about: the workers, or the service on fire
 function paintLogos(providers, caption) {
-  const names = providers.map((p) => (p === 'claude' ? 'Claude' : 'Codex')).join(' + ')
+  const names = providers.map((p) => NAMES[p]).join(' + ')
   const label = names ? `${names} · ${caption}` : ''
   for (const id of ['pet-activity', 'mini-workers']) {
     const badge = el(id)
@@ -1123,22 +1155,27 @@ function render(d) {
 
 function paint() {
   setPlan(el('codex-plan'), codexData?.plan)
+  setPlan(el('cursor-plan'), cursorData?.plan)
+  paintConnections()
   const d0 = lastData
   if (!d0) return
   const view = viewProvider()
   paintServices(view)
   paintCompanion(view)
-  const isCodex = view === 'codex' && !!codexData
-  const cv = isCodex ? codexView(codexData) : null
-  const d = isCodex ? cv.d : d0
-  // % comes only from the connected account (or Codex's own logs) — no estimates
-  const liveOn = isCodex || !!realUsage
+  // Codex or Cursor on screen: their own numbers, never Claude's
+  const ext = view !== 'claude' ? dataOf(view) : null
+  const isExt = !!ext
+  const isCursor = view === 'cursor' && isExt
+  const cv = isExt ? extView(view, ext) : null
+  const d = isExt ? cv.d : d0
+  // % comes only from the connected account (or the service's own data) — no estimates
+  const liveOn = isExt || !!realUsage
   document.body.classList.toggle('live', liveOn)
-  const sessPct = isCodex ? (cv.sess?.pct ?? null) : liveOn ? realUsage.session.pct : 0
-  const sessReset = isCodex ? (cv.sess?.resetMs ?? null) : liveOn ? realUsage.session.resetMs : null
+  const sessPct = isExt ? (cv.sess?.pct ?? null) : liveOn ? realUsage.session.pct : 0
+  const sessReset = isExt ? (cv.sess?.resetMs ?? null) : liveOn ? realUsage.session.resetMs : null
   const sessActive = liveOn && sessReset != null
-  const wkPct = isCodex ? (cv.week?.pct ?? null) : liveOn ? realUsage.week.pct : 0
-  const wkReset = isCodex ? (cv.week?.resetMs ?? null) : liveOn ? realUsage.week.resetMs : null
+  const wkPct = isExt ? (cv.week?.pct ?? null) : liveOn ? realUsage.week.pct : 0
+  const wkReset = isExt ? (cv.week?.resetMs ?? null) : liveOn ? realUsage.week.resetMs : null
   const sp = sessPct ?? 0
   const wp = wkPct ?? 0
 
@@ -1216,16 +1253,23 @@ function paint() {
             : 'idle'
   el('status-text').textContent = word
   el('mini-text').textContent = word
-  el('rate').textContent =
-    d.active && d.tokensPerMin > 0
+  // Cursor's transcripts carry no tokens: when it last ran is what there is to say
+  const ranAgo = isCursor && ext.lastSeen ? Date.now() - ext.lastSeen : null
+  el('rate').textContent = isCursor
+    ? ranAgo == null
+      ? 'no agent runs yet'
+      : ranAgo < 60000
+        ? 'agent ran just now'
+        : `agent ran ${fmtReset(ranAgo)} ago`
+    : d.active && d.tokensPerMin > 0
       ? `${fmtTokens(d.tokensPerMin)} tok/min`
       : `${fmtTokens(d.today.tokens)} tokens today`
 
   const was = prevPct[view]
   if (liveOn && was != null && sessActive && sessPct != null && was - sessPct > 25) {
     celebrate()
-    // Codex's own reset is called out by listenCodex, on screen or not
-    if (!isCodex) say(Voice.recapLine(takeRecap(was), fmtTokens, fmtReset), { headline: true })
+    // Codex's and Cursor's own resets are called out by listenExt, on screen or not
+    if (!isExt) say(Voice.recapLine(takeRecap(was), fmtTokens, fmtReset), { headline: true })
   }
   prevPct[view] = sessPct
   el('session-pct').textContent = pctText(liveOn ? sessPct : 0)
@@ -1244,15 +1288,24 @@ function paint() {
   sf.style.width = `${sp}%`
   sf.classList.toggle('high', sp >= 80)
   setLevel(sf, sp)
-  el('session-sub').textContent = isCodex
-    ? codexSub(cv.sess, d.session.tokens, cv.stale)
+  el('session-label').textContent = isCursor ? 'this month · included' : 'current session'
+  el('week-label').textContent = isCursor ? 'API models · this month' : 'weekly · all models'
+  el('session-sub').textContent = isExt
+    ? isCursor
+      ? extSub(
+          cv.sess,
+          null,
+          cv.stale,
+          ext.signedOut ? 'sign in to the Cursor app' : 'no reading yet',
+        )
+      : extSub(cv.sess, d.session.tokens, cv.stale)
     : sessActive
       ? `resets in ${fmtResetIn(sessReset)} · ${fmtTokens(d.session.tokens)} tokens`
       : 'no active session'
 
-  // where this pace is taking you — Claude's only: Codex has no trail to read
+  // where this pace is taking you — Claude's only: the others have no trail to read
   const proj =
-    !isCodex && sessActive && sp < 100 ? burn.project(sp, sessReset, d.session.tokens) : null
+    !isExt && sessActive && sp < 100 ? burn.project(sp, sessReset, d.session.tokens) : null
   const pe = el('session-proj')
   pe.hidden = !proj
   pe.classList.toggle('tight', proj?.kind === 'eta')
@@ -1267,13 +1320,15 @@ function paint() {
   wf.style.width = `${wp}%`
   wf.classList.toggle('high', wp >= 80)
   setLevel(wf, wp)
-  el('week-sub').textContent = isCodex
-    ? codexSub(cv.week, d.week.tokens, cv.stale)
+  el('week-sub').textContent = isExt
+    ? isCursor
+      ? extSub(cv.week, null, cv.stale, '—')
+      : extSub(cv.week, d.week.tokens, cv.stale)
     : wkReset != null
       ? `resets in ${fmtResetIn(wkReset)} · ${fmtTokens(d.week.tokens)} tokens`
       : `${fmtTokens(d.week.tokens)} tokens · last 7 days`
 
-  renderScoped(!isCodex && liveOn ? realUsage.scoped || [] : [], d.byModel || [])
+  renderScoped(!isExt && liveOn ? realUsage.scoped || [] : [], d.byModel || [])
   renderModels(d.byModel || [])
   renderProjects(d.byProject || [])
   renderHeat(d.days30 || [])
@@ -1293,7 +1348,7 @@ function paint() {
     stopEating()
   }
 
-  listen(before, st, { isCodex, liveOn, sp, sessReset, proj })
+  listen(before, st, { isExt, liveOn, sp, sessReset, proj })
   fitSize()
 }
 
@@ -1304,10 +1359,12 @@ function fitSize() {
   requestAnimationFrame(() => {
     const collapsed = document.body.classList.contains('collapsed')
     const zoom = Number.parseFloat(document.body.style.zoom) || 1
-    // The dual-service dock trades height for a little horizontal room.
+    // The multi-service dock trades height for a little horizontal room, and
+    // three readings widen the pet-only glance.
     const dual = document.body.classList.contains('dual')
+    const trio = document.body.classList.contains('trio')
     const petOnly = document.body.classList.contains('pet-only')
-    const w = (petOnly ? 168 : collapsed ? (dual ? 240 : 192) : 304) * zoom
+    const w = (petOnly ? (trio ? 212 : 168) : collapsed ? (dual ? 240 : 192) : 304) * zoom
     // offsetHeight never reflects a CSS zoom applied to an ancestor (confirmed
     // empirically against this Electron build) — so measure the unzoomed content
     // height, then scale the whole thing (content + margin) ourselves
@@ -1349,6 +1406,9 @@ window.api.onConfig((cfg) => {
   document.body.classList.toggle('codex-on', !!currentConfig.codex)
   if (!currentConfig.codex) codexData = null
   if (!currentConfig.codex) activityTracker.forget('codex')
+  document.body.classList.toggle('cursor-on', !!currentConfig.cursor)
+  if (!currentConfig.cursor) cursorData = null
+  if (!currentConfig.cursor) activityTracker.forget('cursor')
   if (!sizeLoaded) {
     sizeLoaded = true
     let size = 'expanded'
@@ -1370,6 +1430,11 @@ window.api.onCodex((c) => {
   reactToProvider('codex', codexOn() ? c : null)
   paint()
 })
+window.api.onCursor((c) => {
+  cursorData = c || null
+  reactToProvider('cursor', cursorOn() ? c : null)
+  paint()
+})
 window.api.onRealUsage((u) => {
   realUsage = u || null
   realUsageReadAt = u ? Date.now() : 0
@@ -1388,7 +1453,7 @@ window.api.onAuthState((s) => {
     endLogin()
     showProfile(null)
   }
-  paint() // losing Claude can leave Codex as the only service
+  paint() // losing Claude can leave Codex or Cursor as the only service
   if (document.body.classList.contains('settings-open')) fitSize()
 })
 
@@ -1397,6 +1462,7 @@ let lastProfile = null
 function showProfile(p) {
   lastProfile = p
   paintChip()
+  paintConnections()
 }
 
 // The chip is also the account switcher, so it must not vanish just because the
@@ -1415,14 +1481,16 @@ function paintChip() {
   el('acc-ok').title = email || 'Connected'
   const chip = el('account-chip')
   const mini = el('mini-acct')
-  // the Codex view never borrows Claude's identity: its logs carry no email
-  if (viewProvider() === 'codex') {
-    const plan = codexData?.plan || null
-    el('ac-email').textContent = 'Codex'
-    chip.title = 'Codex on this computer'
+  // the Codex and Cursor views never borrow Claude's identity
+  const view = viewProvider()
+  if (view !== 'claude') {
+    const plan = dataOf(view)?.plan || null
+    const name = NAMES[view]
+    el('ac-email').textContent = name
+    chip.title = `${name} on this computer`
     setPlan(el('ac-plan'), plan)
     chip.hidden = false
-    el('mini-acct-name').textContent = 'Codex'
+    el('mini-acct-name').textContent = name
     setPlan(el('mini-acct-plan'), plan)
     mini.hidden = false
     return
@@ -1564,8 +1632,8 @@ function toggleAccountMenu() {
 
 el('account-chip').addEventListener('click', (e) => {
   e.stopPropagation()
-  // Codex has no account switcher: its chip leads to its Settings block
-  if (viewProvider() === 'codex') return openSettings()
+  // Codex and Cursor have no account switcher: their chip leads to their card
+  if (viewProvider() !== 'claude') return openSettings(viewProvider())
   toggleAccountMenu()
 })
 // clicking anywhere else — the pet, the gear, another app — puts it away
@@ -1745,6 +1813,34 @@ el('codex-setup-cancel').addEventListener('click', () => {
 })
 el('codex-disconnect').addEventListener('click', () => window.api.codexEnable(false))
 
+// Settings → Cursor: the same, but what it looks for is the Cursor app's login
+function endCursorSetup() {
+  document.body.classList.remove('cursor-setup')
+  el('cursor-setup').hidden = true
+  el('cursor-hint').textContent = 'Track Cursor alongside Claude, in this pet.'
+}
+el('cursor-connect').addEventListener('click', () => {
+  el('cursor-hint').textContent = 'Looking…'
+  window.api.cursorDetect()
+})
+el('cursor-retry').addEventListener('click', () => window.api.cursorDetect())
+window.api.onCursorDetected((r) => {
+  if (r?.found) {
+    endCursorSetup()
+    window.api.cursorEnable(true)
+    return
+  }
+  document.body.classList.add('cursor-setup')
+  el('cursor-setup').hidden = false
+  el('cursor-hint').textContent = 'Not signed in — open the Cursor app and log in'
+  fitSize()
+})
+el('cursor-setup-cancel').addEventListener('click', () => {
+  endCursorSetup()
+  fitSize()
+})
+el('cursor-disconnect').addEventListener('click', () => window.api.cursorEnable(false))
+
 // account login (browser flow)
 el('acc-connect').addEventListener('click', () => window.api.authStart())
 // main opened the browser — the only thing left to do is paste the code back,
@@ -1752,7 +1848,7 @@ el('acc-connect').addEventListener('click', () => window.api.authStart())
 window.api.onAuthPending(() => {
   // the login can start from the account menu, with the panel closed: the code
   // field is where the flow continues, so bring it up
-  openSettings()
+  openSettings('claude')
   document.body.classList.add('awaiting')
   el('acc-paste').classList.add('show')
   el('acc-code').classList.remove('filled')
@@ -1887,14 +1983,50 @@ function populateSettings() {
   reflectTalkOn()
   clearSaveDirty() // fields now match the saved config
 }
-function openSettings() {
+// `provider` opens that service's connection card straight away
+function openSettings(provider = null) {
   hideBubble()
   setDisplaySize('expanded', false)
   populateSettings()
+  if (typeof provider === 'string') openConnection(provider)
   document.body.classList.add('settings-open')
   fitSize()
 }
 
+// Settings → Connections: a tile per service says whether it's on (a check and
+// its plan); a click opens its card underneath, one at a time
+let openConn = null
+function openConnection(provider) {
+  openConn = provider
+  paintConnections()
+  fitSize()
+}
+function paintConnections() {
+  const plans = { claude: lastProfile?.plan, codex: codexData?.plan, cursor: cursorData?.plan }
+  for (const p of PROVIDERS) {
+    const tile = el(`conn-${p}`)
+    const on = isOn(p)
+    const plan = on ? plans[p] || null : null
+    const open = openConn === p
+    tile.setAttribute('aria-expanded', String(open))
+    tile.classList.toggle('on', on)
+    tile.querySelector('.conn-check').hidden = !on
+    const state = el(`conn-${p}-state`)
+    state.textContent = on ? plan || 'Connected' : 'Connect'
+    state.classList.toggle('plan-badge', !!plan)
+    tile.setAttribute(
+      'aria-label',
+      `${NAMES[p]} · ${on ? `connected${plan ? `, ${plan}` : ''}` : 'not connected'}`,
+    )
+    el(p === 'claude' ? 'account' : `${p}-settings`).classList.toggle('open', open)
+  }
+}
+for (const tile of document.querySelectorAll('.conn-tile')) {
+  tile.addEventListener('click', () =>
+    openConnection(openConn === tile.dataset.conn ? null : tile.dataset.conn),
+  )
+}
+
 // Leaving settings plays the panel out to the right while home slides back in.
 // The panel is lifted out of the flow for those few frames (see .settings-closing
 // in the stylesheet), so the card can already be measured at its home height.
@@ -1903,6 +2035,9 @@ function closeSettings() {
   if (!document.body.classList.contains('settings-open')) return
   abandonLogin()
   endCodexSetup()
+  endCursorSetup()
+  openConn = null
+  paintConnections()
   document.body.classList.remove('settings-open')
   document.body.classList.add('settings-closing')
   clearTimeout(closingTimer)
@@ -1915,8 +2050,9 @@ el('gear').addEventListener('click', () => {
   if (document.body.classList.contains('settings-open')) closeSettings()
   else openSettings()
 })
+
 // the "connect" placeholder jumps straight to settings
-el('limits-connect').addEventListener('click', openSettings)
+el('limits-connect').addEventListener('click', () => openSettings('claude'))
 // custom number steppers (▲ / ▼)
 for (const b of document.querySelectorAll('.num-btn')) {
   b.addEventListener('click', () => {