@masslessai/push-todo 3.1.0 → 3.2.1

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "push-todo",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "Voice tasks from Push iOS app"
 }

package/lib/cli.js

@@ -15,7 +15,7 @@ import { ensureDaemonRunning, getDaemonStatus, startDaemon, stopDaemon } from '.
 import { getScreenshotPath, screenshotExists, openScreenshot } from './utils/screenshots.js';
 import { bold, red, cyan, dim, green } from './utils/colors.js';
 
-const VERSION = '3.1.0';
+const VERSION = '3.2.1';
 
 const HELP_TEXT = `
 ${bold('push-todo')} - Voice tasks from Push iOS app for Claude Code

package/package.json

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

package/scripts/postinstall.js

@@ -2,11 +2,14 @@
 /**
  * Post-install script for Push CLI.
  *
- * 1. Sets up Claude Code plugin symlink
- * 2. Downloads the native keychain helper binary for macOS
+ * Sets up integrations for ALL detected AI coding clients:
+ * 1. Claude Code - symlink to ~/.claude/plugins/
+ * 2. OpenAI Codex - AGENTS.md in ~/.codex/
+ * 3. Clawdbot - SKILL.md in ~/.clawdbot/skills/
+ * 4. Downloads native keychain helper binary (macOS)
  */
 
-import { createWriteStream, existsSync, mkdirSync, unlinkSync, readFileSync, symlinkSync, lstatSync, readlinkSync, rmSync } from 'fs';
+import { createWriteStream, existsSync, mkdirSync, unlinkSync, readFileSync, writeFileSync, symlinkSync, lstatSync, readlinkSync, rmSync, appendFileSync } from 'fs';
 import { chmod, stat } from 'fs/promises';
 import { pipeline } from 'stream/promises';
 import { join, dirname } from 'path';
@@ -19,15 +22,24 @@ const __dirname = dirname(__filename);
 // Package root (one level up from scripts/)
 const PACKAGE_ROOT = join(__dirname, '..');
 
-// Claude Code plugin locations
+// Claude Code locations
 const CLAUDE_DIR = join(homedir(), '.claude');
 const PLUGIN_DIR = join(CLAUDE_DIR, 'plugins');
 const PLUGIN_LINK = join(PLUGIN_DIR, 'push-todo');
-
-// Legacy location (for migration)
 const LEGACY_SKILL_DIR = join(CLAUDE_DIR, 'skills');
 const LEGACY_SKILL_LINK = join(LEGACY_SKILL_DIR, 'push-todo');
 
+// OpenAI Codex locations
+const CODEX_DIR = join(homedir(), '.codex');
+const CODEX_SKILL_DIR = join(CODEX_DIR, 'skills', 'push-todo');
+const CODEX_SKILL_FILE = join(CODEX_SKILL_DIR, 'SKILL.md');
+const CODEX_AGENTS_FILE = join(CODEX_DIR, 'AGENTS.md');
+
+// Clawdbot locations
+const CLAWDBOT_DIR = join(homedir(), '.clawdbot');
+const CLAWDBOT_SKILL_DIR = join(CLAWDBOT_DIR, 'skills', 'push-todo');
+const CLAWDBOT_SKILL_FILE = join(CLAWDBOT_SKILL_DIR, 'SKILL.md');
+
 const BINARY_NAME = 'push-keychain-helper';
 const BINARY_DIR = join(__dirname, '../bin');
 const BINARY_PATH = join(BINARY_DIR, BINARY_NAME);
@@ -130,6 +142,189 @@ function migrateFromPython() {
   }
 }
 
+/**
+ * Set up OpenAI Codex integration.
+ * Creates ~/.codex/skills/push-todo/SKILL.md and updates AGENTS.md
+ *
+ * @returns {boolean} True if Codex was detected and set up
+ */
+function setupCodex() {
+  // Only set up if Codex directory exists (user has Codex installed)
+  if (!existsSync(CODEX_DIR)) {
+    return false;
+  }
+
+  console.log('[push-todo] Detected OpenAI Codex installation');
+
+  // Skill file content
+  const SKILL_CONTENT = `# Push Tasks Skill
+
+This skill retrieves and processes tasks sent from the Push iOS app.
+
+## Activation
+
+This skill activates when the user:
+- Says "push-todo", "push todo", "push tasks", or "tasks from push"
+- Runs \`$push-todo\` command
+- Mentions "tasks from iPhone" or "mobile tasks"
+- Asks about "pending tasks" or "voice tasks"
+
+## Commands
+
+Run these in the terminal:
+
+| Command | Description |
+|---------|-------------|
+| \`push-todo\` | List active tasks |
+| \`push-todo 427\` | Show task #427 |
+| \`push-todo connect\` | Connect/fix issues |
+| \`push-todo search "query"\` | Search tasks |
+| \`push-todo --help\` | All options |
+
+## Instructions
+
+When this skill is activated:
+
+1. **Check connection** - If user hasn't set up, run:
+   \`\`\`bash
+   push-todo connect
+   \`\`\`
+
+2. **Fetch tasks** - List available tasks:
+   \`\`\`bash
+   push-todo
+   \`\`\`
+
+3. **Work on specific task** - Get task details:
+   \`\`\`bash
+   push-todo 427
+   \`\`\`
+
+4. **Present the task** to the user with a brief summary and offer to help implement it.
+`;
+
+  // AGENTS.md bootstrap content
+  const AGENTS_SECTION = `
+## Push Tasks Integration
+
+At the start of each session, check for pending tasks from the Push iOS app:
+
+1. Run this command silently:
+   \`\`\`bash
+   push-todo --json 2>/dev/null | head -1
+   \`\`\`
+
+2. If tasks exist, inform the user:
+   "You have X task(s) from Push. Type $push-todo to see them."
+
+3. If no output or error, proceed normally without mentioning Push.
+`;
+
+  try {
+    // Create skill directory and SKILL.md
+    mkdirSync(CODEX_SKILL_DIR, { recursive: true });
+    writeFileSync(CODEX_SKILL_FILE, SKILL_CONTENT);
+    console.log('[push-todo] Codex: Created skills/push-todo/SKILL.md');
+
+    // Update AGENTS.md for session-start bootstrap
+    if (existsSync(CODEX_AGENTS_FILE)) {
+      const content = readFileSync(CODEX_AGENTS_FILE, 'utf8');
+      if (content.includes('Push Tasks Integration')) {
+        // Update existing section (replace old Python references)
+        const updated = content.replace(
+          /## Push Tasks Integration[\s\S]*?(?=\n## |$)/,
+          AGENTS_SECTION.trim() + '\n\n'
+        );
+        writeFileSync(CODEX_AGENTS_FILE, updated);
+        console.log('[push-todo] Codex: Updated AGENTS.md');
+      } else {
+        appendFileSync(CODEX_AGENTS_FILE, AGENTS_SECTION);
+        console.log('[push-todo] Codex: Added to AGENTS.md');
+      }
+    } else {
+      writeFileSync(CODEX_AGENTS_FILE, AGENTS_SECTION.trim() + '\n');
+      console.log('[push-todo] Codex: Created AGENTS.md');
+    }
+
+    return true;
+  } catch (error) {
+    console.log(`[push-todo] Codex: Setup failed: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * Set up Clawdbot integration.
+ * Creates ~/.clawdbot/skills/push-todo/SKILL.md
+ *
+ * @returns {boolean} True if Clawdbot was detected and set up
+ */
+function setupClawdbot() {
+  // Only set up if Clawdbot directory exists (user has Clawdbot installed)
+  if (!existsSync(CLAWDBOT_DIR)) {
+    return false;
+  }
+
+  console.log('[push-todo] Detected Clawdbot installation');
+
+  const SKILL_CONTENT = `# Push Tasks
+
+Voice tasks captured on iPhone, ready to work on.
+
+## Commands
+
+Run these in the terminal:
+
+| Command | Description |
+|---------|-------------|
+| \`push-todo\` | List active tasks |
+| \`push-todo 427\` | Show task #427 |
+| \`push-todo connect\` | Connect/fix issues |
+| \`push-todo search "query"\` | Search tasks |
+| \`push-todo --help\` | All options |
+
+## Quick Start
+
+If not connected yet, run:
+\`\`\`bash
+push-todo connect
+\`\`\`
+
+To see tasks:
+\`\`\`bash
+push-todo
+\`\`\`
+
+To work on a specific task:
+\`\`\`bash
+push-todo 427
+\`\`\`
+
+## Session Start
+
+At the start of each session, check for tasks:
+\`\`\`bash
+push-todo --json 2>/dev/null | head -1
+\`\`\`
+If tasks exist, inform the user.
+`;
+
+  try {
+    mkdirSync(CLAWDBOT_SKILL_DIR, { recursive: true });
+
+    if (existsSync(CLAWDBOT_SKILL_FILE)) {
+      console.log('[push-todo] Clawdbot: SKILL.md already exists, updating...');
+    }
+
+    writeFileSync(CLAWDBOT_SKILL_FILE, SKILL_CONTENT);
+    console.log('[push-todo] Clawdbot: Created skills/push-todo/SKILL.md');
+    return true;
+  } catch (error) {
+    console.log(`[push-todo] Clawdbot: Could not set up SKILL.md: ${error.message}`);
+    return false;
+  }
+}
+
 /**
  * Download a file from URL to destination.
  *
@@ -184,35 +379,66 @@ async function main() {
 
   // Step 3: Set up Claude Code plugin symlink
   console.log('[push-todo] Setting up Claude Code plugin...');
-  const pluginSuccess = setupClaudePlugin();
+  const claudeSuccess = setupClaudePlugin();
   console.log('');
 
-  // Step 4: Download native binary (macOS only)
+  // Step 4: Set up OpenAI Codex (if installed)
+  const codexSuccess = setupCodex();
+  if (codexSuccess) console.log('');
+
+  // Step 5: Set up Clawdbot (if installed)
+  const clawdbotSuccess = setupClawdbot();
+  if (clawdbotSuccess) console.log('');
+
+  // Track which clients were set up
+  const clients = [];
+  if (claudeSuccess) clients.push('Claude Code');
+  if (codexSuccess) clients.push('OpenAI Codex');
+  if (clawdbotSuccess) clients.push('Clawdbot');
+
+  // Step 6: Download native binary (macOS only)
   if (platform() !== 'darwin') {
     console.log('[push-todo] Skipping native binary (macOS only)');
     console.log('[push-todo] E2EE features will not be available.');
     console.log('');
-    console.log('[push-todo] Installation complete.');
-    if (pluginSuccess) {
-      console.log('[push-todo] You can now use /push-todo in Claude Code!');
+    console.log('[push-todo] Installation complete!');
+    if (clients.length > 0) {
+      console.log(`[push-todo] Configured for: ${clients.join(', ')}`);
     }
     return;
   }
 
   // Check if binary already exists and is valid
+  let binaryExists = false;
   if (existsSync(BINARY_PATH)) {
     try {
       const stats = await stat(BINARY_PATH);
       if (stats.size > 0) {
         console.log('[push-todo] Native binary already installed.');
-        console.log('[push-todo] Installation complete.');
-        return;
+        binaryExists = true;
       }
     } catch {
       // Continue to download
     }
   }
 
+  if (binaryExists) {
+    // Skip download, show summary
+    console.log('');
+    console.log('[push-todo] Installation complete!');
+    if (clients.length > 0) {
+      console.log(`[push-todo] Configured for: ${clients.join(', ')}`);
+    }
+    console.log('');
+    console.log('[push-todo] Quick start:');
+    console.log('[push-todo]   push-todo connect     Set up authentication');
+    console.log('[push-todo]   push-todo             List your tasks');
+    if (claudeSuccess) console.log('[push-todo]   /push-todo            Use in Claude Code');
+    if (codexSuccess) console.log('[push-todo]   $push-todo            Use in OpenAI Codex');
+    if (clawdbotSuccess) console.log('[push-todo]   /push-todo            Use in Clawdbot');
+    return;
+  }
+
   // Determine architecture
   const archType = arch();
   const url = archType === 'arm64' ? BINARY_URL : BINARY_URL_X64;
@@ -233,11 +459,22 @@ async function main() {
 
   console.log('');
   console.log('[push-todo] Installation complete!');
+  if (clients.length > 0) {
+    console.log(`[push-todo] Configured for: ${clients.join(', ')}`);
+  }
   console.log('');
   console.log('[push-todo] Quick start:');
   console.log('[push-todo]   push-todo connect     Set up authentication');
   console.log('[push-todo]   push-todo             List your tasks');
-  console.log('[push-todo]   /push-todo            Use in Claude Code');
+  if (claudeSuccess) {
+    console.log('[push-todo]   /push-todo            Use in Claude Code');
+  }
+  if (codexSuccess) {
+    console.log('[push-todo]   $push-todo            Use in OpenAI Codex');
+  }
+  if (clawdbotSuccess) {
+    console.log('[push-todo]   /push-todo            Use in Clawdbot');
+  }
 }
 
 main().catch(error => {