feat: add cashclaw-cli for headless CLI operation

package.json

@@ -6,7 +6,8 @@
   "author": "Moltlaunch",
   "type": "module",
   "bin": {
-    "cashclaw": "./dist/index.js"
+    "cashclaw": "./dist/index.js",
+    "cashclaw-cli": "./dist/cli.js"
   },
   "scripts": {
     "build": "tsup",

src/cli.ts

@@ -0,0 +1,309 @@
+/**
+ * cashclaw CLI entrypoint
+ *
+ * Subcommands:
+ *   init      -- configure cashclaw from CLI (no web UI)
+ *   start     -- start agent daemon (no browser auto-open)
+ *   stop      -- stop running daemon
+ *   status    -- show current config and daemon status
+ *   config    -- show/edit config values
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import readline from "node:readline";
+import { loadConfig, saveConfig, initConfig, isConfigured, getConfigDir, type LLMConfig } from "./config.js";
+import { startAgent } from "./agent.js";
+
+const PID_FILE = path.join(os.homedir(), ".cashclaw", "cashclaw.pid");
+
+// ──────────────────────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────────────────────
+
+function readPid(): number | null {
+  try {
+    const raw = fs.readFileSync(PID_FILE, "utf-8").trim();
+    const pid = parseInt(raw, 10);
+    return isNaN(pid) ? null : pid;
+  } catch {
+    return null;
+  }
+}
+
+function writePid(pid: number): void {
+  const dir = path.dirname(PID_FILE);
+  fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+  fs.writeFileSync(PID_FILE, String(pid));
+}
+
+function removePid(): void {
+  try { fs.unlinkSync(PID_FILE); } catch { /* already removed */ }
+}
+
+function isProcessRunning(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function prompt(rl: readline.Interface, question: string): Promise<string> {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+
+function parseArgs(argv: string[]): { command: string; flags: Record<string, string>; positional: string[] } {
+  const command = argv[0] ?? "help";
+  const flags: Record<string, string> = {};
+  const positional: string[] = [];
+
+  for (let i = 1; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg.startsWith("--")) {
+      const [key, val] = arg.slice(2).split("=");
+      if (val !== undefined) {
+        flags[key] = val;
+      } else if (i + 1 < argv.length && !argv[i + 1].startsWith("--")) {
+        flags[key] = argv[++i];
+      } else {
+        flags[key] = "true";
+      }
+    } else {
+      positional.push(arg);
+    }
+  }
+
+  return { command, flags, positional };
+}
+
+// ──────────────────────────────────────────────────────────────
+// Commands
+// ──────────────────────────────────────────────────────────────
+
+async function cmdInit(flags: Record<string, string>): Promise<void> {
+  console.log("=== CashClaw CLI Init ===\n");
+
+  // Resolve values from flags or environment, falling back to interactive prompts
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  try {
+    // agentId
+    let agentId = flags["agent-id"] ?? flags["agentId"] ?? "";
+    if (!agentId) {
+      agentId = await prompt(rl, "Agent ID (from mltl agent register): ");
+    }
+    agentId = agentId.trim();
+    if (!agentId) {
+      console.error("Error: agentId is required.");
+      process.exit(1);
+    }
+
+    // LLM provider
+    let provider = (flags["provider"] ?? "") as LLMConfig["provider"];
+    const validProviders: LLMConfig["provider"][] = ["anthropic", "openai", "openrouter"];
+    if (!validProviders.includes(provider)) {
+      const raw = await prompt(rl, "LLM provider [anthropic/openai/openrouter] (default: anthropic): ");
+      provider = (raw.trim() || "anthropic") as LLMConfig["provider"];
+    }
+
+    // API key (env takes priority when not passed via flag)
+    const envKeyMap: Record<LLMConfig["provider"], string> = {
+      anthropic: "ANTHROPIC_API_KEY",
+      openai: "OPENAI_API_KEY",
+      openrouter: "OPENROUTER_API_KEY",
+    };
+    const envKey = process.env[envKeyMap[provider]] ?? "";
+    let apiKey = flags["api-key"] ?? flags["apiKey"] ?? envKey;
+    if (!apiKey) {
+      apiKey = await prompt(rl, `API key for ${provider}: `);
+    }
+    apiKey = apiKey.trim();
+    if (!apiKey) {
+      console.error("Error: API key is required.");
+      process.exit(1);
+    }
+
+    // Model
+    const modelDefaults: Record<LLMConfig["provider"], string> = {
+      anthropic: "claude-sonnet-4-6",
+      openai: "gpt-4o",
+      openrouter: "anthropic/claude-sonnet-4-6",
+    };
+    let model = flags["model"] ?? "";
+    if (!model) {
+      const defaultModel = modelDefaults[provider];
+      const raw = await prompt(rl, `Model (default: ${defaultModel}): `);
+      model = raw.trim() || defaultModel;
+    }
+
+    // Specialties (optional)
+    let specialties: string[] = [];
+    const specialtiesFlag = flags["specialties"] ?? "";
+    if (specialtiesFlag) {
+      specialties = specialtiesFlag.split(",").map((s) => s.trim()).filter(Boolean);
+    } else {
+      const raw = await prompt(rl, "Specialties (comma-separated, optional): ");
+      specialties = raw.split(",").map((s) => s.trim()).filter(Boolean);
+    }
+
+    const config = initConfig({ agentId, provider, model, apiKey, specialties });
+    console.log(`\nConfig saved to ${getConfigDir()}/cashclaw.json`);
+    console.log(`Agent ID: ${config.agentId}`);
+    console.log(`Provider: ${config.llm.provider} / ${config.llm.model}`);
+    console.log(`\nRun "cashclaw-daemon" or "cashclaw start" to start the agent.`);
+  } finally {
+    rl.close();
+  }
+}
+
+async function cmdStart(): Promise<void> {
+  if (!isConfigured()) {
+    console.error("Error: not configured. Run `cashclaw init` first.");
+    process.exit(1);
+  }
+
+  // Check if already running
+  const existingPid = readPid();
+  if (existingPid !== null && isProcessRunning(existingPid)) {
+    console.error(`Error: cashclaw is already running (PID ${existingPid}).`);
+    process.exit(1);
+  }
+
+  console.log("Starting CashClaw daemon...");
+  writePid(process.pid);
+
+  const server = await startAgent();
+
+  const shutdown = () => {
+    console.log("\nShutting down...");
+    removePid();
+    server.close();
+    process.exit(0);
+  };
+
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  process.on("exit", removePid);
+
+  console.log(`Dashboard: http://localhost:3777`);
+  console.log(`PID: ${process.pid} (written to ${PID_FILE})`);
+}
+
+function cmdStop(): void {
+  const pid = readPid();
+  if (pid === null) {
+    console.log("cashclaw is not running (no PID file).");
+    return;
+  }
+  if (!isProcessRunning(pid)) {
+    console.log(`cashclaw is not running (stale PID ${pid}).`);
+    removePid();
+    return;
+  }
+  process.kill(pid, "SIGTERM");
+  console.log(`Sent SIGTERM to PID ${pid}.`);
+  removePid();
+}
+
+function cmdStatus(): void {
+  const config = loadConfig();
+  const pid = readPid();
+  const running = pid !== null && isProcessRunning(pid);
+
+  console.log("=== CashClaw Status ===\n");
+  console.log(`Status:   ${running ? `running (PID ${pid})` : "stopped"}`);
+  console.log(`Dashboard: ${running ? "http://localhost:3777" : "N/A"}`);
+  console.log(`Config:   ${getConfigDir()}/cashclaw.json`);
+
+  if (config) {
+    console.log(`\nAgent ID: ${config.agentId}`);
+    console.log(`Provider: ${config.llm.provider} / ${config.llm.model}`);
+    console.log(`Auto quote: ${config.autoQuote} / Auto work: ${config.autoWork}`);
+    console.log(`Max concurrent tasks: ${config.maxConcurrentTasks}`);
+    if (config.specialties.length > 0) {
+      console.log(`Specialties: ${config.specialties.join(", ")}`);
+    }
+  } else {
+    console.log("\nNot configured. Run `cashclaw init` first.");
+  }
+}
+
+function cmdConfigShow(): void {
+  const config = loadConfig();
+  if (!config) {
+    console.log("Not configured. Run `cashclaw init` first.");
+    return;
+  }
+  // Redact API key
+  const display = { ...config, llm: { ...config.llm, apiKey: "***" } };
+  console.log(JSON.stringify(display, null, 2));
+}
+
+function printHelp(): void {
+  console.log(`
+cashclaw-cli — CashClaw CLI mode
+
+Usage:
+  cashclaw-cli init [OPTIONS]    Configure cashclaw (no browser required)
+  cashclaw-cli start             Start agent daemon (no browser auto-open)
+  cashclaw-cli stop              Stop running daemon
+  cashclaw-cli status            Show config and daemon status
+  cashclaw-cli config show       Show current config (API key redacted)
+
+Init options:
+  --agent-id ID          Agent ID (from moltlaunch registration)
+  --provider PROVIDER    LLM provider: anthropic | openai | openrouter
+  --api-key KEY          API key (also reads ANTHROPIC_API_KEY, OPENAI_API_KEY env)
+  --model MODEL          LLM model name
+  --specialties LIST     Comma-separated specialties
+
+Environment variables:
+  ANTHROPIC_API_KEY      Auto-used when provider=anthropic (if no --api-key)
+  OPENAI_API_KEY         Auto-used when provider=openai
+  OPENROUTER_API_KEY     Auto-used when provider=openrouter
+`);
+}
+
+// ──────────────────────────────────────────────────────────────
+// Main
+// ──────────────────────────────────────────────────────────────
+
+async function main(): Promise<void> {
+  const { command, flags, positional } = parseArgs(process.argv.slice(2));
+
+  switch (command) {
+    case "init":
+      await cmdInit(flags);
+      break;
+
+    case "start":
+      await cmdStart();
+      break;
+
+    case "stop":
+      cmdStop();
+      break;
+
+    case "status":
+      cmdStatus();
+      break;
+
+    case "config":
+      if (positional[0] === "show" || flags["show"] === "true") {
+        cmdConfigShow();
+      } else {
+        printHelp();
+      }
+      break;
+
+    default:
+      printHelp();
+  }
+}
+
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : err);
+  process.exit(1);
+});

tsup.config.ts

@@ -1,7 +1,7 @@
 import { defineConfig } from "tsup";
 
 export default defineConfig({
-  entry: ["src/index.ts"],
+  entry: ["src/index.ts", "src/cli.ts"],
   format: ["esm"],
   target: "node20",
   outDir: "dist",