@workermill/agent 0.1.0

package/README.md

@@ -0,0 +1,73 @@
+# @workermill/agent
+
+Run WorkerMill AI workers locally using your Claude Max subscription. The agent polls the WorkerMill cloud dashboard for tasks, runs planning via Claude CLI, and spawns Docker worker containers on your machine.
+
+## Prerequisites
+
+- **Docker Desktop** — [Install Docker](https://docs.docker.com/get-docker/)
+- **Claude Code CLI** — The setup wizard auto-installs this, or install manually:
+  - macOS/Linux/WSL: `curl -fsSL https://claude.ai/install.sh | bash`
+  - Windows PowerShell: `irm https://claude.ai/install.ps1 | iex`
+- **Claude Max subscription** — Run `claude` and sign in with your Claude account
+- **Node.js >= 20** — [Install Node.js](https://nodejs.org/)
+- **WorkerMill account** — Sign up at [workermill.com](https://workermill.com)
+
+## Install & Setup
+
+```bash
+npm install -g @workermill/agent
+```
+
+The setup wizard launches automatically after install. It will:
+1. Check all prerequisites (auto-installs Claude CLI if missing)
+2. Prompt for your API key (from Settings > Integrations on the dashboard)
+3. Validate connectivity to the WorkerMill API
+4. Prompt for your SCM token (GitHub/GitLab/Bitbucket)
+5. Pull the worker Docker image
+6. Save configuration to `~/.workermill/config.json`
+
+## Usage
+
+```bash
+# Start the agent (foreground)
+workermill-agent start
+
+# Start in background (daemon mode)
+workermill-agent start --detach
+
+# Check status
+workermill-agent status
+
+# Stop a background agent
+workermill-agent stop
+```
+
+## How It Works
+
+1. **Agent polls** the cloud API for tasks assigned to your organization
+2. **Planning runs locally** via Claude CLI (using your Claude Max subscription — no per-token API charges)
+3. **Worker containers** spawn locally via Docker, executing code changes
+4. **Logs and status** stream back to the cloud dashboard in real-time
+5. **PRs are created** on your SCM provider (GitHub/GitLab/Bitbucket)
+
+## Configuration
+
+Config is stored at `~/.workermill/config.json` (created by `workermill-agent setup`):
+
+| Field | Default | Description |
+|-------|---------|-------------|
+| `apiUrl` | `https://workermill.com` | WorkerMill API URL |
+| `apiKey` | — | Organization API key |
+| `agentId` | `agent-<hostname>` | Unique agent identifier |
+| `maxWorkers` | `2` | Max concurrent worker containers |
+| `workerImage` | `public.ecr.aws/a7k5r0v0/workermill-worker:latest` | Docker image for workers |
+
+## Troubleshooting
+
+| Issue | Solution |
+|-------|----------|
+| "No config found" | Run `workermill-agent setup` |
+| Auth failure | Check API key in Settings > Integrations |
+| Docker not found | Install Docker Desktop and ensure it's running |
+| Claude CLI not found | See install instructions above |
+| Image pull fails | Check internet and try `docker pull public.ecr.aws/a7k5r0v0/workermill-worker:latest` |

package/dist/api.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared Axios instance for talking to the WorkerMill cloud API.
+ * Configured lazily after config is loaded.
+ */
+import { type AxiosInstance } from "axios";
+/**
+ * Initialize the shared API client.
+ */
+export declare function initApi(baseUrl: string, apiKey: string): void;
+/**
+ * Get the shared API client. Must call initApi() first.
+ */
+export declare const api: AxiosInstance;

package/dist/api.js

@@ -0,0 +1,29 @@
+/**
+ * Shared Axios instance for talking to the WorkerMill cloud API.
+ * Configured lazily after config is loaded.
+ */
+import axios from "axios";
+let _api = null;
+/**
+ * Initialize the shared API client.
+ */
+export function initApi(baseUrl, apiKey) {
+    _api = axios.create({
+        baseURL: baseUrl,
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+        },
+        timeout: 30_000,
+    });
+}
+/**
+ * Get the shared API client. Must call initApi() first.
+ */
+export const api = new Proxy({}, {
+    get(_target, prop) {
+        if (!_api)
+            throw new Error("API client not initialized. Call initApi() first.");
+        return _api[prop];
+    },
+});

package/dist/cli.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * WorkerMill Remote Agent CLI
+ *
+ * Smart default: running `workermill-agent` with no args auto-launches
+ * setup if no config exists, or starts the agent if already configured.
+ */
+export {};

package/dist/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+/**
+ * WorkerMill Remote Agent CLI
+ *
+ * Smart default: running `workermill-agent` with no args auto-launches
+ * setup if no config exists, or starts the agent if already configured.
+ */
+import { existsSync } from "fs";
+import { Command } from "commander";
+import { setupCommand } from "./commands/setup.js";
+import { startCommand } from "./commands/start.js";
+import { stopCommand } from "./commands/stop.js";
+import { statusCommand } from "./commands/status.js";
+import { logsCommand } from "./commands/logs.js";
+import { pullCommand } from "./commands/pull.js";
+import { getConfigFile } from "./config.js";
+const program = new Command();
+program
+    .name("workermill-agent")
+    .description("WorkerMill Remote Agent - Run AI workers locally with your Claude Max subscription")
+    .version("0.1.0");
+program
+    .command("setup")
+    .description("Interactive setup wizard - configure API key, validate prerequisites, pull worker image")
+    .action(setupCommand);
+program
+    .command("start")
+    .description("Start the agent, polling the cloud API for tasks")
+    .option("--detach", "Run in background (daemon mode)")
+    .action(startCommand);
+program
+    .command("stop")
+    .description("Stop the running agent")
+    .action(stopCommand);
+program
+    .command("status")
+    .description("Show agent status, active containers, and API connectivity")
+    .action(statusCommand);
+program
+    .command("logs")
+    .description("Live tail of agent logs (like tail -f)")
+    .option("-n, --lines <count>", "Number of lines to show initially", "50")
+    .action(logsCommand);
+program
+    .command("pull")
+    .description("Pull the latest worker Docker image")
+    .action(pullCommand);
+// If no command given, auto-detect: run setup if no config, otherwise start
+if (process.argv.length <= 2) {
+    if (existsSync(getConfigFile())) {
+        startCommand({ detach: false });
+    }
+    else {
+        setupCommand();
+    }
+}
+else {
+    program.parse();
+}

package/dist/commands/logs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logs Command — Live tail of agent logs.
+ *
+ * Works like `tail -f ~/.workermill/agent.log`.
+ * Shows the last N lines then follows new output.
+ */
+export declare function logsCommand(options: {
+    lines?: string;
+}): Promise<void>;

package/dist/commands/logs.js

@@ -0,0 +1,52 @@
+/**
+ * Logs Command — Live tail of agent logs.
+ *
+ * Works like `tail -f ~/.workermill/agent.log`.
+ * Shows the last N lines then follows new output.
+ */
+import chalk from "chalk";
+import { existsSync, readFileSync, watchFile, statSync, openSync, readSync, closeSync } from "fs";
+import { getLogFile } from "../config.js";
+export async function logsCommand(options) {
+    const logFile = getLogFile();
+    if (!existsSync(logFile)) {
+        console.log(chalk.yellow("No log file found."));
+        console.log(chalk.dim(`Expected at: ${logFile}`));
+        console.log(chalk.dim("Start the agent with --detach to generate logs."));
+        return;
+    }
+    const tailLines = parseInt(options.lines || "50", 10);
+    // Show last N lines
+    const content = readFileSync(logFile, "utf-8");
+    const lines = content.split("\n");
+    const startIdx = Math.max(0, lines.length - tailLines);
+    const tail = lines.slice(startIdx).join("\n");
+    if (tail.trim()) {
+        process.stdout.write(tail);
+        if (!tail.endsWith("\n"))
+            process.stdout.write("\n");
+    }
+    console.log(chalk.dim(`── Following ${logFile} (Ctrl+C to stop) ──`));
+    // Follow new output
+    let lastSize = statSync(logFile).size;
+    watchFile(logFile, { interval: 500 }, () => {
+        try {
+            const currentSize = statSync(logFile).size;
+            if (currentSize <= lastSize) {
+                lastSize = currentSize;
+                return;
+            }
+            const fd = openSync(logFile, "r");
+            const buffer = Buffer.alloc(currentSize - lastSize);
+            readSync(fd, buffer, 0, buffer.length, lastSize);
+            closeSync(fd);
+            process.stdout.write(buffer.toString());
+            lastSize = currentSize;
+        }
+        catch {
+            // File may have been rotated
+        }
+    });
+    // Keep process alive
+    await new Promise(() => { });
+}

package/dist/commands/pull.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Pull Command — Pull the latest worker Docker image.
+ */
+export declare function pullCommand(): Promise<void>;

package/dist/commands/pull.js

@@ -0,0 +1,35 @@
+/**
+ * Pull Command — Pull the latest worker Docker image.
+ */
+import chalk from "chalk";
+import { spawnSync } from "child_process";
+import { existsSync } from "fs";
+import { loadConfigFromFile, getConfigFile } from "../config.js";
+export async function pullCommand() {
+    let workerImage = "public.ecr.aws/a7k5r0v0/workermill-worker:latest";
+    // Use configured image if config exists
+    if (existsSync(getConfigFile())) {
+        const config = loadConfigFromFile();
+        workerImage = config.workerImage || workerImage;
+    }
+    console.log();
+    console.log(chalk.dim(`  Pulling worker image: ${workerImage}`));
+    console.log(chalk.dim("  This may take a few minutes..."));
+    console.log();
+    const result = spawnSync("docker", ["pull", workerImage], {
+        stdio: "inherit",
+        timeout: 600_000,
+    });
+    console.log();
+    if (result.status === 0) {
+        console.log(chalk.green(`  ✓ Worker image updated`));
+    }
+    else {
+        console.log(chalk.red("  ✗ Failed to pull worker image."));
+        if (result.error) {
+            console.log(chalk.yellow(`  Error: ${result.error.message}`));
+        }
+        console.log(chalk.yellow("  Is Docker Desktop running?"));
+        process.exit(1);
+    }
+}

package/dist/commands/setup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Setup Wizard — Interactive configuration for the WorkerMill Remote Agent.
+ *
+ * Prerequisites checked/installed:
+ *   - Docker Desktop (must be installed manually)
+ *   - Git for Windows (must be installed manually — required by Claude Code on Windows)
+ *   - Claude CLI → winget on Windows, curl | bash on Linux/macOS/WSL
+ *   - Claude auth → launches `claude` which prompts for sign-in on first run
+ *   - Worker image → `docker pull public.ecr.aws/a7k5r0v0/workermill-worker:latest`
+ */
+export declare function setupCommand(): Promise<void>;