@masslessai/push-todo 4.2.3 → 4.2.5

package/README.md

@@ -1,69 +1,94 @@
 # @masslessai/push-todo
 
-Voice tasks from the [Push iOS app](https://pushto.do) for Claude Code.
+Voice tasks from the [Push iOS app](https://pushto.do) for Claude Code, Codex, and OpenClaw.
 
 ## Installation
 
 ```bash
 npm install -g @masslessai/push-todo
+push-todo connect --auto
 ```
 
+The install sets up skill integrations for all detected agents (Claude Code, Codex, OpenClaw). The `connect --auto` command handles authentication, project discovery, and LaunchAgent installation in one step.
+
 ## Quick Start
 
 ```bash
-# Authenticate and set up
-push-todo connect
-
 # List your tasks
 push-todo
 
 # Work on a specific task
 push-todo 427
+
+# Create a task from the terminal
+push-todo create "Fix the auth redirect bug"
+
+# Queue tasks for background execution
+push-todo --queue 1,2,3
 ```
 
 ## Features
 
 - **Voice Tasks**: Tasks captured by voice on your iPhone sync to your terminal
-- **Project Filtering**: Automatically shows tasks relevant to your current git repo
-- **E2EE Support**: End-to-end encrypted tasks are decrypted using your iCloud Keychain
-- **Claude Code Integration**: Works as a Claude Code plugin with `/push-todo` command
-- **Daemon Execution**: Background task execution with progress monitoring
+- **Background Daemon**: Executes tasks automatically via Claude Code (or Codex/OpenClaw) in git worktrees
+- **LaunchAgent**: Daemon starts on login and restarts on crash — no manual babysitting
+- **Multi-Agent**: Same CLI works with Claude Code, OpenAI Codex, and OpenClaw
+- **Project Routing**: AI routes voice tasks to the right project using learned vocabulary
+- **E2EE Support**: End-to-end encrypted tasks decrypted via iCloud Keychain
+- **Cron Jobs**: Schedule recurring notifications and health checks
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `push-todo` | List active tasks |
+| `push-todo` | List active tasks for current project |
 | `push-todo <number>` | View specific task |
-| `push-todo connect` | Authenticate and set up |
+| `push-todo create <title>` | Create a new todo |
+| `push-todo connect --auto` | One-command setup (auth + projects + daemon) |
+| `push-todo connect` | Run connection diagnostics |
 | `push-todo search <query>` | Search tasks |
-| `push-todo status` | Show connection status |
+| `push-todo review` | Review and mark completed tasks |
+| `push-todo update` | Update CLI and check agent versions |
 | `push-todo --watch` | Live monitoring UI |
+| `push-todo --queue 1,2,3` | Queue tasks for daemon execution |
+| `push-todo --queue-batch` | Auto-queue a batch of tasks |
+| `push-todo --resume <number>` | Resume daemon's Claude session for a task |
+| `push-todo --all-projects` | Tasks from all projects |
+| `push-todo --backlog` | Show backlog items |
+| `push-todo --completed` | Show completed items |
+| `push-todo --json` | Output as JSON |
 
-## Claude Code Integration
-
-This package works as a Claude Code plugin:
+## Daemon Management
 
-```
-/push-todo              List your voice tasks
-/push-todo 427          Work on task #427
-/push-todo connect      Run diagnostics
+```bash
+push-todo --daemon-status       # Show daemon + LaunchAgent status
+push-todo --daemon-install      # Install LaunchAgent (auto-start on login)
+push-todo --daemon-uninstall    # Remove LaunchAgent
+push-todo --daemon-start        # Start daemon manually
+push-todo --daemon-stop         # Stop daemon
 ```
 
-### Session Hooks
+The daemon self-updates hourly when idle. Two-layer reliability: LaunchAgent for OS-level lifecycle, self-healing for edge cases.
 
-- **Session Start**: Shows task count notification
-- **Session End**: Reports session completion
-
-## Options
+## Cron Jobs
 
 ```bash
-push-todo --all-projects     # Tasks from all projects
-push-todo --backlog          # Show backlog items
-push-todo --include-backlog  # Include backlog in list
-push-todo --completed        # Show completed items
-push-todo --json             # Output as JSON
-push-todo --queue 1,2,3      # Queue tasks for daemon
+push-todo cron add --name "standup" --every 24h --notify "Time for standup"
+push-todo cron add --name "weekly-review" --cron "0 9 * * 1" --create-todo "Weekly code review"
+push-todo cron add --name "check-deps" --every 7d --health-check /path/to/project --scope deps
+push-todo cron list
+push-todo cron remove <id>
+```
+
+## Claude Code Integration
+
+This package installs as a Claude Code skill (not plugin) for a clean `/push-todo` command:
+
+```
+/push-todo              List your voice tasks
+/push-todo 427          Work on task #427
+/push-todo review       Review completed tasks
+/push-todo setup        Configure connection
 ```
 
 ## Configuration
@@ -71,37 +96,33 @@ push-todo --queue 1,2,3      # Queue tasks for daemon
 Config stored at `~/.config/push/config`:
 
 ```bash
-push-todo setting            # Show all settings
-push-todo setting auto-commit # Toggle auto-commit
+push-todo setting                # Show all settings
+push-todo setting auto-commit    # Toggle auto-commit
+push-todo setting auto-update    # Toggle daemon self-update
 ```
 
-## Requirements
-
-- Node.js 18+
-- macOS (for E2EE features)
-- [Push iOS app](https://apps.apple.com/app/push-todo/id6738972839)
-
-## API
+## Programmatic API
 
 ```javascript
 import { listTasks, showTask, searchTasks } from '@masslessai/push-todo';
 
-// List tasks
 const tasks = await listTasks({ allProjects: true });
-
-// Get specific task
 const task = await showTask(427);
-
-// Search
-const results = await searchTasks('bug');
+const results = await searchTasks('auth bug');
 ```
 
+## Requirements
+
+- Node.js 18+
+- macOS (for LaunchAgent and E2EE)
+- [Push iOS app](https://pushto.do)
+
 ## Documentation
 
-- [Skill Documentation](./SKILL.md)
+- [Skill Instructions](./SKILL.md) — how the AI agent uses push-todo
 - [Push Website](https://pushto.do)
-- [Support](mailto:support@pushto.do)
+- [GitHub Issues](https://github.com/MasslessAI/push-todo-cli/issues)
 
 ## License
 
-MIT © [MasslessAI](https://masslessai.com)
+MIT

package/lib/daemon.js

@@ -91,6 +91,7 @@ const LOG_FILE = join(PUSH_DIR, 'daemon.log');
 const STATUS_FILE = join(PUSH_DIR, 'daemon_status.json');
 const VERSION_FILE = join(PUSH_DIR, 'daemon.version');
 const LOCK_FILE = join(PUSH_DIR, 'daemon.lock');
+const COMPLETED_FILE = join(PUSH_DIR, 'completed_tasks.json');
 const CONFIG_FILE = join(CONFIG_DIR, 'config');
 const MACHINE_ID_FILE = join(CONFIG_DIR, 'machine_id');
 const REGISTRY_FILE = join(CONFIG_DIR, 'projects.json');
@@ -110,6 +111,25 @@ function trackCompleted(entry) {
   if (completedToday.length > COMPLETED_TODAY_MAX) {
     completedToday.splice(0, completedToday.length - COMPLETED_TODAY_MAX);
   }
+  // Persist to disk so new daemon instances skip already-completed tasks
+  try {
+    writeFileSync(COMPLETED_FILE, JSON.stringify(completedToday));
+  } catch {}
+}
+
+function loadCompletedTasks() {
+  try {
+    if (!existsSync(COMPLETED_FILE)) return;
+    const data = JSON.parse(readFileSync(COMPLETED_FILE, 'utf8'));
+    if (!Array.isArray(data)) return;
+    // Only load entries from the last 24 hours
+    const cutoff = Date.now() - 86400000;
+    for (const entry of data) {
+      if (entry.completedAt && new Date(entry.completedAt).getTime() > cutoff) {
+        completedToday.push(entry);
+      }
+    }
+  } catch {}
 }
 const taskLastOutput = new Map(); // displayNumber -> timestamp
 const taskStdoutBuffer = new Map(); // displayNumber -> lines[]
@@ -886,6 +906,16 @@ function createPRForTask(displayNumber, summary, projectPath) {
   const gitCwd = projectPath || process.cwd();
 
   try {
+    // Verify branch exists before comparing (worktree may have been auto-cleaned)
+    try {
+      execFileSync('git', ['rev-parse', '--verify', branch], {
+        cwd: gitCwd, timeout: 5000, stdio: 'pipe'
+      });
+    } catch {
+      log(`Branch ${branch} does not exist, skipping PR creation`);
+      return null;
+    }
+
     // Check if branch has commits
     const logResult = execSync(`git log HEAD..${branch} --oneline`, {
       cwd: gitCwd,
@@ -1666,6 +1696,8 @@ function respawnWithInjectedMessage(displayNumber) {
   const claudeArgs = [
     '--continue', sessionId,
     '-p', injectionPrompt,
+    '--verbose',
+    '--worktree', getWorktreeName(displayNumber),
     '--allowedTools', allowedTools,
     '--output-format', 'stream-json',
     '--permission-mode', 'bypassPermissions',
@@ -2330,6 +2362,8 @@ async function executeTask(task) {
     ? [
         '--continue', previousSessionId,
         '-p', prompt,
+        '--verbose',
+        '--worktree', worktreeName,
         '--allowedTools', allowedTools,
         '--output-format', 'stream-json',
         '--permission-mode', 'bypassPermissions',
@@ -2337,6 +2371,8 @@ async function executeTask(task) {
       ]
     : [
         '-p', prompt,
+        '--verbose',
+        '--worktree', worktreeName,
         '--allowedTools', allowedTools,
         '--output-format', 'stream-json',
         '--permission-mode', 'bypassPermissions',
@@ -3059,6 +3095,7 @@ If dependencies are current, say "All dependencies up to date."`,
 
   const claudeArgs = [
     '-p', prompt,
+    '--verbose',
     '--allowedTools', allowedTools,
     '--output-format', 'stream-json',
     '--permission-mode', 'bypassPermissions',
@@ -3196,6 +3233,14 @@ async function recoverOrphanedTasks() {
     for (const task of orphaned) {
       const dn = task.displayNumber || task.display_number;
       const tid = task.id || task.todo_id || null;
+
+      // Skip tasks already completed by the previous daemon instance
+      // (race condition: API may return stale 'running' status after session_finished update)
+      if (completedToday.some(c => c.displayNumber === dn)) {
+        log(`Task #${dn}: skipping orphan recovery — already completed by previous daemon`);
+        continue;
+      }
+
       log(`Task #${dn}: resetting from 'running' to 'queued' (orphaned by restart)`);
       await updateTaskStatus(dn, 'queued', {
         event: {
@@ -3255,6 +3300,9 @@ async function mainLoop() {
     writeFileSync(VERSION_FILE, getVersion());
   } catch {}
 
+  // Load completed tasks from previous daemon instance (prevents re-execution)
+  loadCompletedTasks();
+
   // Recover orphaned tasks from previous daemon instance
   // When the daemon restarts (self-update, crash, reboot), tasks may be stuck
   // in 'running' with no process actually working on them. Reset them to 'queued'

package/lib/launchagent.js

@@ -68,7 +68,7 @@ function generatePlist() {
         <key>PUSH_DAEMON</key>
         <string>1</string>
         <key>PATH</key>
-        <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:${dirname(nodeBin)}</string>
+        <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin:${dirname(nodeBin)}:${join(homedir(), '.local', 'bin')}</string>
     </dict>
 
     <key>RunAtLoad</key>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masslessai/push-todo",
-  "version": "4.2.3",
+  "version": "4.2.5",
   "description": "Voice tasks from Push iOS app for Claude Code",
   "type": "module",
   "bin": {