zerg-status 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Zerg CLI - Status reporting for AI coding agents
+ *
+ * Usage:
+ *   zerg init --name "My task"           # Initialize agent session
+ *   zerg status working                  # Report working status
+ *   zerg status blocked "Need help"      # Report blocked with question
+ *   zerg status done                     # Report task complete
+ *   zerg task "Implementing feature"     # Update current task
+ *   zerg pr https://github.com/...       # Report PR ready
+ *   zerg ask "Which approach?"           # Ask user a question
+ *
+ * Environment:
+ *   ZERG_API_URL   - Status store URL (default: https://zerg-status.vercel.app)
+ *   ZERG_TOKEN     - Auth token
+ *   ZERG_AGENT_ID  - Agent ID (auto-detected if not set)
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+/**
+ * Zerg CLI - Status reporting for AI coding agents
+ *
+ * Usage:
+ *   zerg init --name "My task"           # Initialize agent session
+ *   zerg status working                  # Report working status
+ *   zerg status blocked "Need help"      # Report blocked with question
+ *   zerg status done                     # Report task complete
+ *   zerg task "Implementing feature"     # Update current task
+ *   zerg pr https://github.com/...       # Report PR ready
+ *   zerg ask "Which approach?"           # Ask user a question
+ *
+ * Environment:
+ *   ZERG_API_URL   - Status store URL (default: https://zerg-status.vercel.app)
+ *   ZERG_TOKEN     - Auth token
+ *   ZERG_AGENT_ID  - Agent ID (auto-detected if not set)
+ */
+import { execSync } from 'child_process';
+import { hostname } from 'os';
+const API_URL = process.env.ZERG_API_URL || 'https://zerg-status.vercel.app';
+const TOKEN = process.env.ZERG_TOKEN || '';
+// Detect agent ID from environment
+function getAgentId() {
+    // Explicit ID takes priority
+    if (process.env.ZERG_AGENT_ID) {
+        return process.env.ZERG_AGENT_ID;
+    }
+    // Devin session
+    if (process.env.DEVIN_SESSION_ID) {
+        return `devin:${process.env.DEVIN_SESSION_ID}`;
+    }
+    // Git-based ID for local sessions
+    try {
+        const repo = execSync('basename $(git rev-parse --show-toplevel) 2>/dev/null', {
+            encoding: 'utf8',
+        }).trim();
+        const branch = execSync('git rev-parse --abbrev-ref HEAD 2>/dev/null', {
+            encoding: 'utf8',
+        }).trim();
+        if (repo && branch) {
+            return `local:${repo}:${branch}`;
+        }
+    }
+    catch {
+        // Not in a git repo
+    }
+    // Fallback to hostname + pid
+    return `local:${hostname()}:${process.pid}`;
+}
+// Send update to API
+async function sendUpdate(payload) {
+    const url = `${API_URL}/api/agent`;
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (TOKEN) {
+        headers['Authorization'] = `Bearer ${TOKEN}`;
+    }
+    const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        console.error(`Error: ${response.status} ${text}`);
+        process.exit(1);
+    }
+    const result = await response.json();
+    console.log(JSON.stringify(result, null, 2));
+}
+// Parse CLI arguments
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const command = args[0] || 'help';
+    return { command, args: args.slice(1) };
+}
+// Command handlers
+const commands = {
+    async init(args) {
+        const nameIdx = args.indexOf('--name');
+        const name = nameIdx >= 0 ? args[nameIdx + 1] : undefined;
+        await sendUpdate({
+            agent_id: getAgentId(),
+            name,
+            status: 'working',
+        });
+    },
+    async status(args) {
+        const status = args[0];
+        if (!status || !['working', 'blocked', 'review', 'done', 'paused'].includes(status)) {
+            console.error('Usage: zerg status <working|blocked|review|done|paused> [message]');
+            process.exit(1);
+        }
+        const payload = {
+            agent_id: getAgentId(),
+            status,
+        };
+        // If blocked, treat second arg as question
+        if (status === 'blocked' && args[1]) {
+            payload.question = args.slice(1).join(' ');
+        }
+        await sendUpdate(payload);
+    },
+    async task(args) {
+        if (args.length === 0) {
+            console.error('Usage: zerg task "description"');
+            process.exit(1);
+        }
+        await sendUpdate({
+            agent_id: getAgentId(),
+            current_task: args.join(' '),
+        });
+    },
+    async ask(args) {
+        if (args.length === 0) {
+            console.error('Usage: zerg ask "question"');
+            process.exit(1);
+        }
+        await sendUpdate({
+            agent_id: getAgentId(),
+            status: 'blocked',
+            question: args.join(' '),
+        });
+    },
+    async pr(args) {
+        if (args.length === 0) {
+            console.error('Usage: zerg pr <url>');
+            process.exit(1);
+        }
+        await sendUpdate({
+            agent_id: getAgentId(),
+            pr: args[0],
+            status: 'review',
+        });
+    },
+    async error(args) {
+        await sendUpdate({
+            agent_id: getAgentId(),
+            status: 'blocked',
+            error: args.join(' ') || 'Unknown error',
+        });
+    },
+    async get(_args) {
+        const url = `${API_URL}/api/agent?id=${encodeURIComponent(getAgentId())}`;
+        const headers = {};
+        if (TOKEN)
+            headers['Authorization'] = `Bearer ${TOKEN}`;
+        const response = await fetch(url, { headers });
+        const data = await response.json();
+        console.log(JSON.stringify(data, null, 2));
+    },
+    async list(_args) {
+        const url = `${API_URL}/api/agent`;
+        const headers = {};
+        if (TOKEN)
+            headers['Authorization'] = `Bearer ${TOKEN}`;
+        const response = await fetch(url, { headers });
+        const data = await response.json();
+        console.log(JSON.stringify(data, null, 2));
+    },
+    async help(_args) {
+        console.log(`
+Zerg CLI - Status reporting for AI coding agents
+
+Commands:
+  init [--name "Task name"]     Initialize agent session
+  status <state> [message]      Update status (working|blocked|review|done|paused)
+  task "description"            Update current task description
+  ask "question"                Ask user a question (sets blocked status)
+  pr <url>                      Report PR ready for review
+  error [message]               Report an error
+  get                           Get current agent status
+  list                          List all agents
+
+Environment:
+  ZERG_API_URL    API endpoint (default: https://zerg-status.vercel.app)
+  ZERG_TOKEN      Auth token for writes
+  ZERG_AGENT_ID   Override agent ID (auto-detected from git/env)
+
+Examples:
+  zerg init --name "Implement dark mode"
+  zerg status working
+  zerg task "Adding theme toggle component"
+  zerg ask "Should I use CSS variables or Tailwind?"
+  zerg pr https://github.com/org/repo/pull/123
+  zerg status done
+`);
+    },
+};
+// Main
+async function main() {
+    const { command, args } = parseArgs();
+    const handler = commands[command];
+    if (!handler) {
+        console.error(`Unknown command: ${command}`);
+        console.error('Run "zerg help" for usage');
+        process.exit(1);
+    }
+    await handler(args);
+}
+main().catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "zerg-status",
+  "version": "0.1.0",
+  "description": "CLI for AI coding agents to report status to a central store",
+  "type": "module",
+  "bin": {
+    "zerg": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "status",
+    "cli",
+    "devin",
+    "claude",
+    "coding-agent"
+  ],
+  "author": "Exa Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/exa-labs/zerg"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  }
+}