vibe-pomo 0.1.0 → 0.1.1

package/README.md

@@ -2,8 +2,17 @@
 
 > You and your agent, both in flow.
 
+[![npm version](https://img.shields.io/npm/v/vibe-pomo)](https://www.npmjs.com/package/vibe-pomo)
+[![npm downloads](https://img.shields.io/npm/dm/vibe-pomo)](https://www.npmjs.com/package/vibe-pomo)
+
 <!-- screenshot: dashboard terminal showing active sessions + project stats -->
 
+<!-- README-I18N:START -->
+
+**English** | [汉语](./README.zh.md)
+
+<!-- README-I18N:END -->
+
 ---
 
 ## Why vibe-pomo
@@ -79,7 +88,7 @@ This gets saved alongside the agent's summary, giving you a dual-perspective rec
 **Prerequisites:** Node.js 20+, Claude Code CLI
 
 ```bash
-npm install -g vibe-pomo
+npm i -g vibe-pomo
 pomodoro install
 ```
 

package/README.zh.md

@@ -0,0 +1,208 @@
+# vibe-pomo 🍅
+
+> 你和你的 AI 代理，同时进入心流。
+
+<!-- screenshot: dashboard terminal showing active sessions + project stats -->
+
+<!-- README-I18N:START -->
+
+[English](./README.md) | **汉语**
+
+<!-- README-I18N:END -->
+
+---
+
+## 为什么选择 vibe-pomo
+
+大多数 AI 编码工具都建立在一个假设上：你始终在旁边盯着。每一次工具调用、每一个决策、每一次完成——代理 ping 你、等你、打断你。每次交互看似微小，但累积起来代价巨大：你从未能获得超过几分钟的不间断专注。
+
+**vibe-pomo 反转了这一切。** 启动一个番茄钟，把任务交给代理，然后离开。代理自主工作——通知静音、决策排队、零打扰。计时结束后，由*你*决定何时回来，而不是代理。
+
+**双向深度专注。**
+为自己屏蔽干扰，让代理同时运行不间断的工作会话。没有上下文切换，没有被动响应循环。两条并行的心流，在你准备好时汇聚。
+
+**清楚地知道时间去哪了。**
+每次会话都会记录代理完成的工作以及你自己做的事情。查看每个项目的专注时间、浏览会话历史，精确了解时间的流向——为个人复盘和项目规划提供清晰的记录。
+
+---
+
+## 工作原理
+
+两个终端，两个角色：
+
+```
+终端 A — 守护进程（保持打开）        终端 B — Claude Code 对话
+─────────────────────────────────    ───────────────────────────────────────
+$ pomodoro daemon                    /pomodoro 25m Fix auth bug
+                                                |
+  🍅 Pomodoro  daemon running                   +---> 计时器窗口打开
+                                                      代理开始工作
+  Active Sessions                               通知静音
+   23:41  my-project  Fix auth bug              工具调用自动批准
+
+  Project Focus Time
+   my-project  ████████████░░  3h 45m
+
+  Recent Sessions
+   my-project  Fix auth bug
+    🤖 Rewrote JWT middleware
+    👤 Had a planning call
+```
+
+```
+计时器窗口（每个会话）
+──────────────────────────────────
+  🍅 Pomodoro
+
+        +02:13  OVERTIME
+
+  Task: Fix auth bug
+
+  Notifications
+  ┌──────────────────────────────┐
+  │ Build passed                 │
+  │ Tests: 42 passed             │
+  └──────────────────────────────┘
+
+  [E] End Session   [B] Break   [Q] Quit
+```
+
+计时结束后，排队的通知会被释放，并提示你记录在此期间*你*做了什么：
+
+```
+What did you do during this session?
+(optional — press Enter to skip)
+
+> Reviewed the RFC, had a planning call with the team
+```
+
+这条记录会与代理的总结一同保存，为每次会话提供双视角记录。
+
+---
+
+## 安装
+
+**前置条件：** Node.js 20+、Claude Code CLI
+
+```bash
+npm install -g vibe-pomo
+pomodoro install
+```
+
+`pomodoro install` 会在 `~/.claude/settings.json` 中注册三个 Claude Code 钩子，并安装 `/pomodoro`、`/pomodoro-stats` 和 `/pomodoro-stop` 斜杠命令：
+
+- **PreToolUse** — 在会话期间自动批准所有工具调用
+- **Notification** — 静默排队通知，直到计时结束
+- **Stop** — 在会话结束前让代理保持等待状态
+
+> 这三个钩子在**没有活跃番茄钟时会立即退出且无任何效果**，不会干扰其他任何 Claude Code 配置或斜杠命令框架。
+
+---
+
+## 使用方法
+
+### 1. 启动守护进程（一次，保持该终端打开）
+
+```bash
+pomodoro daemon
+```
+
+显示实时仪表板：带倒计时的活跃会话、各项目专注时间及最近会话历史。
+
+### 2. 开始一个会话
+
+```bash
+# 在 Claude Code 中（推荐）
+/pomodoro 25m Refactor the auth module
+
+# 在任意终端中
+pomodoro start 25m Refactor the auth module
+pomodoro start Refactor the auth module    # 使用默认时长
+```
+
+计时器窗口打开，代理开始工作，你自由了。
+
+### 3. 会话进行中
+
+代理自主工作——工具调用自动批准、通知排队、决策记录。你可以在不退出的情况下通过 Claude Code 查看进度：
+
+```
+/pomodoro-stats    查看时间追踪统计
+/pomodoro-stop     中断当前会话
+```
+
+### 4. 计时结束后
+
+计时器切换为超时模式，排队的通知显示出来。按 **E** 结束会话，记录你的工作内容，然后在 `.claude/pomodoro-summary.md` 和 `.claude/pomodoro-pending.md` 中查看代理的总结及待处理决策。
+
+### 5. 查看统计数据
+
+```bash
+pomodoro stats
+```
+
+```
+Project Focus Time
+──────────────────────────────────────────────────────────────────
+my-project      ████████████████░░░░░░░░░░░░░░    4h 20m
+side-project    ██████░░░░░░░░░░░░░░░░░░░░░░░░    1h 45m
+
+Recent Sessions
+──────────────────────────────────────────────────────────────────
+4/13  my-project   Refactor auth module      28m  completed
+  🤖  Rewrote JWT middleware, pending: refresh token expiry strategy
+  👤  Read RFC, had planning call with team
+
+4/13  my-project   Fix payment webhook       18m  completed
+  🤖  Found and fixed Stripe signature validation bug
+  👤  Coffee, cleared inbox
+```
+
+---
+
+## 配置
+
+首次运行时会创建 `~/.claude/pomodoro.json`：
+
+```json
+{
+  "defaultDurationMs": 1500000,
+  "decisionStrategy": "wait",
+  "terminalEmulator": "auto",
+  "soundOnOvertime": true
+}
+```
+
+| 选项 | 取值 | 说明 |
+|------|------|------|
+| `defaultDurationMs` | 毫秒数 | 默认会话时长（25 分钟 = `1500000`） |
+| `decisionStrategy` | `"wait"` / `"break"` | 代理被阻塞时的策略：静默等待直到你结束会话（默认），或立即结束 |
+| `terminalEmulator` | `"auto"` / 名称 | 计时器窗口使用的终端。从 `$TERM_PROGRAM`、`$KITTY_WINDOW_ID` 等自动检测 |
+| `soundOnOvertime` | 布尔值 | 计时归零时播放提示音 |
+
+---
+
+## 命令
+
+```
+pomodoro daemon                  启动守护进程及实时仪表板
+pomodoro start [dur] [task]      开始一个会话
+pomodoro stop                    中断当前会话
+pomodoro stats                   显示时间追踪统计
+pomodoro install                 向 Claude Code 注册钩子
+pomodoro stop-daemon             停止全局守护进程
+```
+
+时长格式：`25m`、`1h`、`90s`，或纯数字（按分钟处理）。
+
+---
+
+## 兼容性
+
+vibe-pomo 的钩子仅在守护进程运行时激活。没有活跃会话时，三个钩子均立即退出——无输出、无副作用。一个全局守护进程可同时处理你所有的 Claude Code 项目。
+
+---
+
+## 许可证
+
+MIT

package/bin/pomodoro.mjs

@@ -9,7 +9,8 @@ import { MSG, DECISION } from '../src/shared/protocol.mjs'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const ROOT = join(__dirname, '..')
-const TSX = join(ROOT, 'node_modules', '.bin', 'tsx')
+const isWin = process.platform === 'win32'
+const TSX = join(ROOT, 'node_modules', '.bin', isWin ? 'tsx.cmd' : 'tsx')
 
 const [,, cmd, ...args] = process.argv
 
@@ -53,7 +54,7 @@ await handler(args)
 async function cmdDaemon() {
   // Launch dashboard TUI (which also starts the daemon in-process)
   const dashboardEntry = join(ROOT, 'src', 'tui', 'dashboard', 'index.tsx')
-  const child = spawn(TSX, [dashboardEntry], { stdio: 'inherit' })
+  const child = spawn(TSX, [dashboardEntry], { stdio: 'inherit', shell: isWin })
   child.on('exit', (code) => process.exit(code ?? 0))
 }
 
@@ -192,6 +193,10 @@ async function launchTerminal(tsx, entryFile, sessionId, termPref) {
 
 function detectTerminals() {
   const list = []
+  if (isWin) {
+    list.push('wt', 'cmd')
+    return list
+  }
   if (process.env.KITTY_WINDOW_ID)        list.push('kitty')
   if (process.env.TERM_PROGRAM === 'WezTerm') list.push('wezterm')
   list.push('gnome-terminal', 'xfce4-terminal', 'konsole', 'xterm', 'alacritty', 'wezterm', 'kitty')
@@ -199,16 +204,22 @@ function detectTerminals() {
 }
 
 function buildCmd(term, tsx, entryFile, sessionId) {
-  const inner = `${tsx} ${entryFile} ${sessionId}`
+  // Quote paths for Windows (handles spaces in paths like AppData\Roaming\npm\...)
+  const q = isWin ? (p) => `"${p}"` : (p) => p
+  const inner = isWin
+    ? `${q(tsx)} ${q(entryFile)} ${sessionId}`
+    : `${tsx} ${entryFile} ${sessionId}`
   switch (term) {
-    case 'gnome-terminal':   return ['gnome-terminal', '--', 'bash', '-c', inner]
-    case 'xfce4-terminal':   return ['xfce4-terminal', '-e', inner]
-    case 'konsole':          return ['konsole', '-e', inner]
-    case 'xterm':            return ['xterm', '-e', inner]
-    case 'alacritty':        return ['alacritty', '-e', 'bash', '-c', inner]
-    case 'wezterm':          return ['wezterm', 'start', '--', 'bash', '-c', inner]
-    case 'kitty':            return ['kitty', 'bash', '-c', inner]
-    default:                 return null
+    case 'wt':             return ['wt', 'new-tab', '--', 'cmd.exe', '/k', inner]
+    case 'cmd':            return ['cmd.exe', '/c', `start cmd.exe /k "${inner}"`]
+    case 'gnome-terminal': return ['gnome-terminal', '--', 'bash', '-c', inner]
+    case 'xfce4-terminal': return ['xfce4-terminal', '-e', inner]
+    case 'konsole':        return ['konsole', '-e', inner]
+    case 'xterm':          return ['xterm', '-e', inner]
+    case 'alacritty':      return ['alacritty', '-e', 'bash', '-c', inner]
+    case 'wezterm':        return ['wezterm', 'start', '--', 'bash', '-c', inner]
+    case 'kitty':          return ['kitty', 'bash', '-c', inner]
+    default:               return null
   }
 }
 
@@ -218,7 +229,7 @@ function trySpawn(term, tsx, entryFile, sessionId) {
   return new Promise((resolve) => {
     let done = false
     try {
-      const child = spawn(cmd[0], cmd.slice(1), { detached: true, stdio: 'ignore' })
+      const child = spawn(cmd[0], cmd.slice(1), { detached: true, stdio: 'ignore', shell: isWin })
       child.on('error', () => { if (!done) { done = true; resolve(false) } })
       child.on('spawn', () => { if (!done) { done = true; child.unref(); resolve(true) } })
       setTimeout(() => { if (!done) { done = true; child.unref(); resolve(true) } }, 300)

package/install.mjs

@@ -15,6 +15,8 @@ const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json')
 
 export function runInstall() {
   const nodeExec = process.execPath
+  // Quote paths containing spaces (common on Windows)
+  const q = (p) => p.includes(' ') ? `"${p}"` : p
 
   const hookDefs = {
     PreToolUse: [
@@ -22,7 +24,7 @@ export function runInstall() {
         matcher: '.*',
         hooks: [{
           type: 'command',
-          command: `${nodeExec} ${join(HOOKS_DIR, 'preToolUse.mjs')}`,
+          command: `${q(nodeExec)} ${q(join(HOOKS_DIR, 'preToolUse.mjs'))}`,
         }],
       },
     ],
@@ -30,7 +32,7 @@ export function runInstall() {
       {
         hooks: [{
           type: 'command',
-          command: `${nodeExec} ${join(HOOKS_DIR, 'notification.mjs')}`,
+          command: `${q(nodeExec)} ${q(join(HOOKS_DIR, 'notification.mjs'))}`,
         }],
       },
     ],
@@ -38,7 +40,7 @@ export function runInstall() {
       {
         hooks: [{
           type: 'command',
-          command: `${nodeExec} ${join(HOOKS_DIR, 'stop.mjs')}`,
+          command: `${q(nodeExec)} ${q(join(HOOKS_DIR, 'stop.mjs'))}`,
         }],
       },
     ],
@@ -107,6 +109,7 @@ function installSlashCommand() {
 function writePomodoroCommand(dest) {
   const pomodoroPath = join(__dirname, 'bin', 'pomodoro.mjs')
   const nodeExec = process.execPath
+  const q = (p) => p.includes(' ') ? `"${p}"` : p
   writeFileSync(dest, `---
 description: Start a Pomodoro focus session — agent works autonomously until timer ends
 argument-hint: "[duration e.g. 25m] [task description]"
@@ -115,7 +118,7 @@ argument-hint: "[duration e.g. 25m] [task description]"
 ## Step 1: Start the Pomodoro timer
 
 \`\`\`bash
-${nodeExec} ${pomodoroPath} start $ARGUMENTS
+${q(nodeExec)} ${q(pomodoroPath)} start $ARGUMENTS
 \`\`\`
 
 ## Step 2: Work autonomously during the focus session
@@ -135,6 +138,7 @@ The user has started a Pomodoro focus session and **will not be checking the scr
 function writeStatsCommand(dest) {
   const pomodoroPath = join(__dirname, 'bin', 'pomodoro.mjs')
   const nodeExec = process.execPath
+  const q = (p) => p.includes(' ') ? `"${p}"` : p
   writeFileSync(dest, `---
 description: Show Pomodoro time tracking statistics
 ---
@@ -142,7 +146,7 @@ description: Show Pomodoro time tracking statistics
 Run the following command and display the output to the user:
 
 \`\`\`bash
-${nodeExec} ${pomodoroPath} stats
+${q(nodeExec)} ${q(pomodoroPath)} stats
 \`\`\`
 `, 'utf8')
 }
@@ -150,6 +154,7 @@ ${nodeExec} ${pomodoroPath} stats
 function writeStopCommand(dest) {
   const pomodoroPath = join(__dirname, 'bin', 'pomodoro.mjs')
   const nodeExec = process.execPath
+  const q = (p) => p.includes(' ') ? `"${p}"` : p
   writeFileSync(dest, `---
 description: Break (stop) the current Pomodoro session
 ---
@@ -157,7 +162,7 @@ description: Break (stop) the current Pomodoro session
 Run the following command to break the active Pomodoro session:
 
 \`\`\`bash
-${nodeExec} ${pomodoroPath} stop
+${q(nodeExec)} ${q(pomodoroPath)} stop
 \`\`\`
 
 Then confirm to the user that the session has been stopped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-pomo",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "You and your agent, both in flow. A Pomodoro timer for Claude Code that keeps agents working autonomously while you stay deep in focus — uninterrupted.",
   "type": "module",
   "bin": {

package/src/daemon/ipc.mjs

@@ -20,8 +20,8 @@ export class IpcServer {
   }
 
   async listen(socketPath) {
-    // Clean up stale socket file
-    if (existsSync(socketPath)) {
+    // Clean up stale socket file (Unix only — Windows named pipes don't need this)
+    if (process.platform !== 'win32' && existsSync(socketPath)) {
       unlinkSync(socketPath)
     }
 

package/src/shared/lockfile.mjs

@@ -5,7 +5,10 @@ import { join } from 'node:path'
 
 const CLAUDE_DIR = join(homedir(), '.claude')
 const LOCK_PATH = join(CLAUDE_DIR, 'pomodoro.lock')
-const SOCKET_PATH = join(CLAUDE_DIR, 'pomodoro.sock')
+// Windows requires named pipe paths; Unix uses a socket file
+const SOCKET_PATH = process.platform === 'win32'
+  ? '\\\\.\\pipe\\vibe-pomo'
+  : join(CLAUDE_DIR, 'pomodoro.sock')
 
 export function getSocketPath() {
   return SOCKET_PATH
@@ -30,7 +33,8 @@ export function readLock() {
     process.kill(data.pid, 0)
   } catch {
     try { unlinkSync(LOCK_PATH) } catch {}
-    try { unlinkSync(SOCKET_PATH) } catch {}
+    // Named pipes on Windows are kernel-managed; only unlink on Unix
+    if (process.platform !== 'win32') try { unlinkSync(SOCKET_PATH) } catch {}
     return null
   }
   return data
@@ -42,7 +46,8 @@ export function writeLock(data) {
 
 export function removeLock() {
   try { unlinkSync(LOCK_PATH) } catch {}
-  try { unlinkSync(SOCKET_PATH) } catch {}
+  // Named pipes on Windows are kernel-managed; only unlink on Unix
+  if (process.platform !== 'win32') try { unlinkSync(SOCKET_PATH) } catch {}
 }
 
 /** Stable short ID for a project directory */