kindflow 0.3.0 → 0.4.0

package/README.md

@@ -28,24 +28,39 @@ Kindflow is an opinionated platform for running AI agents as independent OS proc
 
 ## Install
 
+```bash
+curl -fsSL https://raw.githubusercontent.com/surajpratap/kindflow/main/install.sh | sh
+```
+
+Or install directly:
+
 ```bash
 npm install -g kindflow
 ```
 
+### Prerequisites
+
+- [Node.js](https://nodejs.org) >= 18
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
+- [bun](https://bun.sh) (for running agent scripts)
+
 ## Quick Start
 
 ```bash
-# Start the daemon (API server on port 7777)
+# Start the daemon (runs in background)
 kindflow start
 
-# Start with the web UI (port 7001)
+# Start with the web UI
 kindflow start --web
 
 # Create an agent
 kindflow create my-first-agent
 
-# List all agents
-kindflow list
+# Check status
+kindflow status
+
+# Stop the daemon
+kindflow stop
 ```
 
 Open http://localhost:7001 to access the dashboard, create agents, and configure them with AI.
@@ -146,11 +161,16 @@ All config and credentials are stored in `~/.kindflow/` (never in the repo):
 ## CLI Reference
 
 ```
-kindflow start [options]     Start the daemon
+kindflow start [options]     Start the daemon (background)
   --web                      Also start the web UI (port 7001)
   --port <n>                 Override the API port
   --web-port <n>             Override the web UI port
   --agents-dir <path>        Override the agents directory
+  --foreground               Run in the foreground (don't daemonize)
+
+kindflow stop                Stop the daemon
+
+kindflow status              Show daemon status (PID, ports, logs)
 
 kindflow create <name>       Create a new agent from template
 

package/chunk-IIHUCTI3.js

@@ -0,0 +1,102 @@
+// ../daemon/src/agent-scanner.ts
+import { resolve, join } from "path";
+import { readdirSync, readFileSync, writeFileSync, existsSync, cpSync, rmSync } from "fs";
+var generateSlug = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+var scanAgents = (agentsDir) => {
+  if (!existsSync(agentsDir)) return [];
+  const agents = [];
+  for (const name of readdirSync(agentsDir, { withFileTypes: true })) {
+    if (!name.isDirectory()) continue;
+    const configPath = join(agentsDir, name.name, "agent", "config.json");
+    if (!existsSync(configPath)) continue;
+    try {
+      const raw = readFileSync(configPath, "utf-8");
+      const config = JSON.parse(raw);
+      const dir = join(agentsDir, name.name);
+      agents.push({
+        id: name.name,
+        dir,
+        config,
+        sdkOptions: {
+          cwd: join(dir, "agent"),
+          model: config.model ?? void 0,
+          permissionMode: config.permissionMode ?? "bypassPermissions",
+          allowDangerouslySkipPermissions: config.permissionMode === "bypassPermissions"
+        }
+      });
+    } catch {
+      console.warn(`[scanner] Failed to read config for ${name.name}, skipping`);
+    }
+  }
+  return agents;
+};
+var readAgent = (agentsDir, id) => {
+  const dir = resolve(agentsDir, id);
+  const configPath = join(dir, "agent", "config.json");
+  if (!existsSync(configPath)) return void 0;
+  try {
+    const raw = readFileSync(configPath, "utf-8");
+    const config = JSON.parse(raw);
+    return {
+      id,
+      dir,
+      config,
+      sdkOptions: {
+        cwd: join(dir, "agent"),
+        model: config.model ?? void 0,
+        permissionMode: config.permissionMode ?? "bypassPermissions",
+        allowDangerouslySkipPermissions: config.permissionMode === "bypassPermissions"
+      }
+    };
+  } catch {
+    return void 0;
+  }
+};
+var writeAgentConfig = (agentsDir, id, config) => {
+  const configPath = resolve(agentsDir, id, "agent", "config.json");
+  writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+};
+var createAgentFromTemplate = (agentsDir, templateDir, id, name, autoStart = true) => {
+  const agentDir = resolve(agentsDir, id);
+  cpSync(templateDir, agentDir, { recursive: true });
+  const config = {
+    name,
+    autoStart,
+    model: null,
+    permissionMode: "bypassPermissions",
+    env: {}
+  };
+  writeAgentConfig(agentsDir, id, config);
+  return {
+    id,
+    dir: agentDir,
+    config,
+    sdkOptions: {
+      cwd: join(agentDir, "agent"),
+      permissionMode: "bypassPermissions",
+      allowDangerouslySkipPermissions: true
+    }
+  };
+};
+var listAgentCommands = (agentsDir, id) => {
+  const commandsDir = resolve(agentsDir, id, "agent", ".claude", "commands");
+  if (!existsSync(commandsDir)) return [];
+  return readdirSync(commandsDir).filter((f) => f.endsWith(".md")).map((f) => f.replace(/\.md$/, ""));
+};
+var deleteAgentDir = (agentsDir, id) => {
+  const agentDir = resolve(agentsDir, id);
+  if (existsSync(agentDir)) {
+    rmSync(agentDir, { recursive: true, force: true });
+  }
+};
+
+export {
+  generateSlug,
+  scanAgents,
+  readAgent,
+  writeAgentConfig,
+  createAgentFromTemplate,
+  listAgentCommands,
+  deleteAgentDir
+};
+//# sourceMappingURL=chunk-IIHUCTI3.js.map

package/chunk-IIHUCTI3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../daemon/src/agent-scanner.ts"],"sourcesContent":["import { resolve, join } from 'path';\nimport { readdirSync, readFileSync, writeFileSync, existsSync, cpSync, rmSync, mkdirSync } from 'fs';\nimport type { AgentConfig, AgentFileConfig } from '@repo/types';\n\n/**\n * Generate a URL-safe slug from a human-readable name.\n * Lowercases, replaces non-alphanumeric chars with hyphens, strips leading/trailing hyphens.\n *\n * @param name - the raw name to slugify\n * @returns a lowercase hyphen-separated slug\n */\nexport const generateSlug = (name: string): string =>\n  name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');\n\n/**\n * Scan the agents directory and discover all agents.\n * An agent is any directory that has an agent/config.json file.\n *\n * @param agentsDir - absolute path to the agents directory\n * @returns array of AgentConfig objects\n */\nexport const scanAgents = (agentsDir: string): AgentConfig[] => {\n  if (!existsSync(agentsDir)) return [];\n\n  const agents: AgentConfig[] = [];\n\n  for (const name of readdirSync(agentsDir, { withFileTypes: true })) {\n    if (!name.isDirectory()) continue;\n\n    const configPath = join(agentsDir, name.name, 'agent', 'config.json');\n    if (!existsSync(configPath)) continue;\n\n    try {\n      const raw = readFileSync(configPath, 'utf-8');\n      const config = JSON.parse(raw) as AgentFileConfig;\n      const dir = join(agentsDir, name.name);\n\n      agents.push({\n        id: name.name,\n        dir,\n        config,\n        sdkOptions: {\n          cwd: join(dir, 'agent'),\n          model: config.model ?? undefined,\n          permissionMode: (config.permissionMode as 'bypassPermissions') ?? 'bypassPermissions',\n          allowDangerouslySkipPermissions: config.permissionMode === 'bypassPermissions',\n        },\n      });\n    } catch {\n      console.warn(`[scanner] Failed to read config for ${name.name}, skipping`);\n    }\n  }\n\n  return agents;\n};\n\n/**\n * Read a single agent's config from the filesystem.\n *\n * @param agentsDir - absolute path to the agents directory\n * @param id - the agent directory name\n * @returns AgentConfig or undefined if not found\n */\nexport const readAgent = (agentsDir: string, id: string): AgentConfig | undefined => {\n  const dir = resolve(agentsDir, id);\n  const configPath = join(dir, 'agent', 'config.json');\n  if (!existsSync(configPath)) return undefined;\n\n  try {\n    const raw = readFileSync(configPath, 'utf-8');\n    const config = JSON.parse(raw) as AgentFileConfig;\n\n    return {\n      id,\n      dir,\n      config,\n      sdkOptions: {\n        cwd: join(dir, 'agent'),\n        model: config.model ?? undefined,\n        permissionMode: (config.permissionMode as 'bypassPermissions') ?? 'bypassPermissions',\n        allowDangerouslySkipPermissions: config.permissionMode === 'bypassPermissions',\n      },\n    };\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * Write an agent's config.json to disk.\n *\n * @param agentsDir - absolute path to the agents directory\n * @param id - the agent directory name\n * @param config - the config to write\n */\nexport const writeAgentConfig = (agentsDir: string, id: string, config: AgentFileConfig): void => {\n  const configPath = resolve(agentsDir, id, 'agent', 'config.json');\n  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\\n');\n};\n\n/**\n * Create a new agent by copying the template and writing config.json.\n *\n * @param agentsDir - absolute path to the agents directory\n * @param templateDir - absolute path to the agent template directory\n * @param id - the agent directory name (slug)\n * @param name - human-readable agent name\n * @param autoStart - whether to auto-start on daemon boot\n * @returns the new AgentConfig\n */\nexport const createAgentFromTemplate = (\n  agentsDir: string,\n  templateDir: string,\n  id: string,\n  name: string,\n  autoStart = true,\n): AgentConfig => {\n  const agentDir = resolve(agentsDir, id);\n\n  /* Copy template. */\n  cpSync(templateDir, agentDir, { recursive: true });\n\n  /* Write config.json with the name. */\n  const config: AgentFileConfig = {\n    name,\n    autoStart,\n    model: null,\n    permissionMode: 'bypassPermissions',\n    env: {},\n  };\n\n  writeAgentConfig(agentsDir, id, config);\n\n  return {\n    id,\n    dir: agentDir,\n    config,\n    sdkOptions: {\n      cwd: join(agentDir, 'agent'),\n      permissionMode: 'bypassPermissions',\n      allowDangerouslySkipPermissions: true,\n    },\n  };\n};\n\n/**\n * List available commands for an agent by scanning .claude/commands/ directory.\n *\n * @param agentsDir - absolute path to the agents directory\n * @param id - the agent directory name\n * @returns array of command names (without .md extension)\n */\nexport const listAgentCommands = (agentsDir: string, id: string): string[] => {\n  const commandsDir = resolve(agentsDir, id, 'agent', '.claude', 'commands');\n  if (!existsSync(commandsDir)) return [];\n\n  return readdirSync(commandsDir)\n    .filter((f) => f.endsWith('.md'))\n    .map((f) => f.replace(/\\.md$/, ''));\n};\n\n/**\n * Delete an agent — removes the entire directory.\n *\n * @param agentsDir - absolute path to the agents directory\n * @param id - the agent directory name\n */\nexport const deleteAgentDir = (agentsDir: string, id: string): void => {\n  const agentDir = resolve(agentsDir, id);\n  if (existsSync(agentDir)) {\n    rmSync(agentDir, { recursive: true, force: true });\n  }\n};\n"],"mappings":"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","names":[]}

package/chunk-S6UDV4I6.js

@@ -0,0 +1,43 @@
+// ../daemon/src/paths.ts
+import { resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var detectMode = () => {
+  if (process.env["KINDFLOW_DEV"] === "1") return "dev";
+  if (import.meta.url.endsWith(".ts")) return "dev";
+  return "cli";
+};
+var devPaths = () => {
+  const repoRoot = resolve(__dirname, "../../..");
+  return {
+    agentsDir: resolve(repoRoot, "apps"),
+    templateDir: resolve(repoRoot, "templates/agent"),
+    dataDir: process.env["KINDFLOW_DATA_DIR"] ?? resolve(homedir(), ".kindflow"),
+    runnersDir: resolve(repoRoot, "packages"),
+    webDir: null
+  };
+};
+var cliPaths = () => {
+  const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve(homedir(), ".kindflow");
+  return {
+    agentsDir: resolve(dataDir, "agents"),
+    templateDir: resolve(__dirname, "templates/agent"),
+    dataDir,
+    runnersDir: __dirname,
+    webDir: resolve(__dirname, "web")
+  };
+};
+var resolvePaths = (overrides) => {
+  const mode = detectMode();
+  const base = mode === "dev" ? devPaths() : cliPaths();
+  return { ...base, ...overrides };
+};
+
+export {
+  detectMode,
+  devPaths,
+  cliPaths,
+  resolvePaths
+};
+//# sourceMappingURL=chunk-S6UDV4I6.js.map

package/chunk-S6UDV4I6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../daemon/src/paths.ts"],"sourcesContent":["/**\n * Centralized path configuration for the Kindflow daemon.\n *\n * In dev mode (monorepo), paths point to workspace directories.\n * In CLI mode (published npm package), paths point to ~/.kindflow/ and the package's dist/.\n */\n\nimport { resolve, dirname } from 'path';\nimport { fileURLToPath } from 'url';\nimport { homedir } from 'os';\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\n/**\n * All configurable paths the daemon needs to operate.\n * Replaces the old `repoRoot` parameter that assumed a monorepo layout.\n */\nexport interface KindflowPaths {\n  /** Where agent directories live (each containing agent/ + master/). */\n  agentsDir: string;\n\n  /** Where agent templates are (copied on `kindflow create`). */\n  templateDir: string;\n\n  /** Where config.db and encryption keys live. */\n  dataDir: string;\n\n  /** Where compiled runner entry scripts are located. */\n  runnersDir: string;\n\n  /** Pre-built web UI directory, or null to skip web serving. */\n  webDir: string | null;\n}\n\n/**\n * Detect whether the daemon is running in dev mode (monorepo) or CLI mode (published package).\n *\n * @returns 'dev' if running from TypeScript source, 'cli' if running from compiled JS\n */\nexport const detectMode = (): 'dev' | 'cli' => {\n  if (process.env['KINDFLOW_DEV'] === '1') return 'dev';\n  if (import.meta.url.endsWith('.ts')) return 'dev';\n  return 'cli';\n};\n\n/**\n * Build the default KindflowPaths for dev mode (Turborepo monorepo).\n *\n * @returns paths pointing to the monorepo workspace directories\n */\nexport const devPaths = (): KindflowPaths => {\n  const repoRoot = resolve(__dirname, '../../..');\n  return {\n    agentsDir: resolve(repoRoot, 'apps'),\n    templateDir: resolve(repoRoot, 'templates/agent'),\n    dataDir: process.env['KINDFLOW_DATA_DIR'] ?? resolve(homedir(), '.kindflow'),\n    runnersDir: resolve(repoRoot, 'packages'),\n    webDir: null,\n  };\n};\n\n/**\n * Build the default KindflowPaths for CLI mode (globally installed npm package).\n *\n * @returns paths pointing to ~/.kindflow/ and the package's dist/\n */\nexport const cliPaths = (): KindflowPaths => {\n  const dataDir = process.env['KINDFLOW_DATA_DIR'] ?? resolve(homedir(), '.kindflow');\n  return {\n    agentsDir: resolve(dataDir, 'agents'),\n    templateDir: resolve(__dirname, 'templates/agent'),\n    dataDir,\n    runnersDir: __dirname,\n    webDir: resolve(__dirname, 'web'),\n  };\n};\n\n/**\n * Resolve KindflowPaths based on the current mode, with optional overrides.\n *\n * @param overrides - partial overrides for specific paths\n * @returns fully resolved KindflowPaths\n */\nexport const resolvePaths = (overrides?: Partial<KindflowPaths>): KindflowPaths => {\n  const mode = detectMode();\n  const base = mode === 'dev' ? devPaths() : cliPaths();\n  return { ...base, ...overrides };\n};\n"],"mappings":";AAOA,SAAS,SAAS,eAAe;AACjC,SAAS,qBAAqB;AAC9B,SAAS,eAAe;AAExB,IAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AA4BjD,IAAM,aAAa,MAAqB;AAC7C,MAAI,QAAQ,IAAI,cAAc,MAAM,IAAK,QAAO;AAChD,MAAI,YAAY,IAAI,SAAS,KAAK,EAAG,QAAO;AAC5C,SAAO;AACT;AAOO,IAAM,WAAW,MAAqB;AAC3C,QAAM,WAAW,QAAQ,WAAW,UAAU;AAC9C,SAAO;AAAA,IACL,WAAW,QAAQ,UAAU,MAAM;AAAA,IACnC,aAAa,QAAQ,UAAU,iBAAiB;AAAA,IAChD,SAAS,QAAQ,IAAI,mBAAmB,KAAK,QAAQ,QAAQ,GAAG,WAAW;AAAA,IAC3E,YAAY,QAAQ,UAAU,UAAU;AAAA,IACxC,QAAQ;AAAA,EACV;AACF;AAOO,IAAM,WAAW,MAAqB;AAC3C,QAAM,UAAU,QAAQ,IAAI,mBAAmB,KAAK,QAAQ,QAAQ,GAAG,WAAW;AAClF,SAAO;AAAA,IACL,WAAW,QAAQ,SAAS,QAAQ;AAAA,IACpC,aAAa,QAAQ,WAAW,iBAAiB;AAAA,IACjD;AAAA,IACA,YAAY;AAAA,IACZ,QAAQ,QAAQ,WAAW,KAAK;AAAA,EAClC;AACF;AAQO,IAAM,eAAe,CAAC,cAAsD;AACjF,QAAM,OAAO,WAAW;AACxB,QAAM,OAAO,SAAS,QAAQ,SAAS,IAAI,SAAS;AACpD,SAAO,EAAE,GAAG,MAAM,GAAG,UAAU;AACjC;","names":[]}

package/cli.js

@@ -1,28 +1,111 @@
 #!/usr/bin/env node
 import {
-  cliPaths,
   createAgentFromTemplate,
-  detectMode,
-  devPaths,
   generateSlug,
-  resolvePaths,
-  scanAgents,
-  startDaemon
-} from "./chunk-Z3MYKB53.js";
-import "./chunk-3AMW7NXZ.js";
-import "./chunk-2YT53FBK.js";
-import "./chunk-2UX7Z5TH.js";
-import "./chunk-GZFR7ELC.js";
-import "./chunk-P5P73L35.js";
+  scanAgents
+} from "./chunk-IIHUCTI3.js";
+import {
+  resolvePaths
+} from "./chunk-S6UDV4I6.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand4, runMain } from "citty";
+import { defineCommand as defineCommand6, runMain } from "citty";
 
 // src/commands/start.ts
 import { defineCommand } from "citty";
-import { mkdirSync } from "fs";
+import { spawn } from "child_process";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync, openSync } from "fs";
 import { resolve, dirname } from "path";
 import { fileURLToPath } from "url";
+import { homedir } from "os";
+var pidFile = () => {
+  const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve(homedir(), ".kindflow");
+  return resolve(dataDir, "daemon.pid");
+};
+var logFile = () => {
+  const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve(homedir(), ".kindflow");
+  return resolve(dataDir, "daemon.log");
+};
+var isRunning = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var readPid = () => {
+  const file = pidFile();
+  if (!existsSync(file)) return null;
+  const pid = parseInt(readFileSync(file, "utf-8").trim(), 10);
+  if (isNaN(pid) || !isRunning(pid)) {
+    try {
+      unlinkSync(file);
+    } catch {
+    }
+    return null;
+  }
+  return pid;
+};
+var buildArgs = (args) => {
+  const result = ["start", "--foreground"];
+  if (args["web"]) result.push("--web");
+  if (args["port"]) result.push("--port", String(args["port"]));
+  if (args["webPort"]) result.push("--web-port", String(args["webPort"]));
+  if (args["agentsDir"]) result.push("--agents-dir", String(args["agentsDir"]));
+  return result;
+};
+var runForeground = async (args) => {
+  const { startDaemon } = await import("./daemon.js");
+  const { detectMode, devPaths, cliPaths } = await import("./paths-5IQQ6WBD.js");
+  const isDev = detectMode() === "dev";
+  const base = isDev ? devPaths() : cliPaths();
+  let webDir = null;
+  if (args["web"]) {
+    if (base.webDir) {
+      webDir = base.webDir;
+    } else {
+      const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../../../..");
+      webDir = resolve(repoRoot, "apps/web");
+    }
+  }
+  const paths = {
+    ...base,
+    webDir,
+    ...args["agentsDir"] ? { agentsDir: resolve(String(args["agentsDir"])) } : {}
+  };
+  mkdirSync(paths.agentsDir, { recursive: true });
+  const port = args["port"] ? parseInt(String(args["port"]), 10) : void 0;
+  const webPort = args["webPort"] ? parseInt(String(args["webPort"]), 10) : void 0;
+  const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve(homedir(), ".kindflow");
+  mkdirSync(dataDir, { recursive: true });
+  writeFileSync(resolve(dataDir, "daemon.pid"), String(process.pid));
+  try {
+    const daemon = await startDaemon({ port, webPort, paths });
+    const handleSignal = async (signal) => {
+      console.log(`
+[kindflow] Received ${signal}`);
+      try {
+        unlinkSync(resolve(dataDir, "daemon.pid"));
+      } catch {
+      }
+      await daemon.shutdown();
+      process.exit(0);
+    };
+    process.on("SIGINT", () => handleSignal("SIGINT"));
+    process.on("SIGTERM", () => handleSignal("SIGTERM"));
+  } catch (err) {
+    try {
+      unlinkSync(resolve(dataDir, "daemon.pid"));
+    } catch {
+    }
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`
+  Failed to start: ${msg}
+`);
+    process.exit(1);
+  }
+};
 var startCommand = defineCommand({
   meta: {
     name: "start",
@@ -45,48 +128,201 @@ var startCommand = defineCommand({
     agentsDir: {
       type: "string",
       description: "Override the agents directory"
+    },
+    foreground: {
+      type: "boolean",
+      description: "Run in the foreground (do not daemonize)",
+      default: false
     }
   },
   async run({ args }) {
-    const isDev = detectMode() === "dev";
-    const base = isDev ? devPaths() : cliPaths();
-    let webDir = null;
-    if (args.web) {
-      if (base.webDir) {
-        webDir = base.webDir;
-      } else {
-        const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../../../..");
-        webDir = resolve(repoRoot, "apps/web");
+    if (args.foreground) {
+      console.log("");
+      console.log("  Kindflow \u2014 The opinionated agent platform");
+      console.log("");
+      await runForeground(args);
+      return;
+    }
+    const existingPid = readPid();
+    if (existingPid) {
+      console.log(`  Kindflow is already running (PID ${existingPid})`);
+      console.log(`  Run "kindflow stop" first, or "kindflow status" for details.`);
+      process.exit(1);
+    }
+    const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve(homedir(), ".kindflow");
+    mkdirSync(dataDir, { recursive: true });
+    const log = logFile();
+    const out = openSync(log, "a");
+    const err = openSync(log, "a");
+    const kindflowBin = process.argv[1];
+    const childArgs = buildArgs(args);
+    const isDev = kindflowBin.endsWith(".ts");
+    const execArgs = isDev ? ["--import", "tsx", kindflowBin, ...childArgs] : [kindflowBin, ...childArgs];
+    const child = spawn(process.execPath, execArgs, {
+      detached: true,
+      stdio: ["ignore", out, err],
+      env: { ...process.env }
+    });
+    child.unref();
+    await new Promise((resolve5) => {
+      const timeout = setTimeout(() => {
+        resolve5();
+      }, 2e3);
+      child.on("exit", (code) => {
+        clearTimeout(timeout);
+        if (code !== 0) {
+          console.log("");
+          console.log(`  Failed to start. Check logs: ${log}`);
+          console.log("");
+          try {
+            const content = readFileSync(log, "utf-8");
+            const lines = content.trim().split("\n").slice(-10);
+            for (const line of lines) {
+              console.log(`  ${line}`);
+            }
+          } catch {
+          }
+          process.exit(1);
+        }
+        resolve5();
+      });
+    });
+    const pid = readPid();
+    if (pid) {
+      console.log("");
+      console.log("  Kindflow \u2014 The opinionated agent platform");
+      console.log("");
+      console.log(`  Daemon running (PID ${pid})`);
+      console.log(`  API:  http://localhost:${args.port ?? "7777"}`);
+      if (args.web) {
+        console.log(`  Web:  http://localhost:${args.webPort ?? "7001"}`);
       }
+      console.log(`  Logs: ${log}`);
+      console.log("");
+      console.log(`  Run "kindflow stop" to shut down.`);
+      console.log("");
+    } else {
+      console.log("");
+      console.log(`  Failed to start. Check logs: ${log}`);
+      console.log("");
+      process.exit(1);
+    }
+  }
+});
+
+// src/commands/stop.ts
+import { defineCommand as defineCommand2 } from "citty";
+import { readFileSync as readFileSync2, existsSync as existsSync2, unlinkSync as unlinkSync2 } from "fs";
+import { resolve as resolve2 } from "path";
+import { homedir as homedir2 } from "os";
+var isRunning2 = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var stopCommand = defineCommand2({
+  meta: {
+    name: "stop",
+    description: "Stop the Kindflow daemon"
+  },
+  run() {
+    const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve2(homedir2(), ".kindflow");
+    const pidPath = resolve2(dataDir, "daemon.pid");
+    if (!existsSync2(pidPath)) {
+      console.log("  Kindflow is not running.");
+      return;
+    }
+    const pid = parseInt(readFileSync2(pidPath, "utf-8").trim(), 10);
+    if (isNaN(pid) || !isRunning2(pid)) {
+      console.log("  Kindflow is not running (stale PID file removed).");
+      try {
+        unlinkSync2(pidPath);
+      } catch {
+      }
+      return;
+    }
+    process.kill(pid, "SIGTERM");
+    console.log(`  Stopping Kindflow (PID ${pid})...`);
+    const start = Date.now();
+    const maxWait = 1e4;
+    const poll = setInterval(() => {
+      if (!isRunning2(pid)) {
+        clearInterval(poll);
+        try {
+          unlinkSync2(pidPath);
+        } catch {
+        }
+        console.log("  Stopped.");
+        process.exit(0);
+      }
+      if (Date.now() - start > maxWait) {
+        clearInterval(poll);
+        console.log(`  Process did not stop gracefully. Sending SIGKILL...`);
+        try {
+          process.kill(pid, "SIGKILL");
+        } catch {
+        }
+        try {
+          unlinkSync2(pidPath);
+        } catch {
+        }
+        console.log("  Killed.");
+        process.exit(0);
+      }
+    }, 200);
+  }
+});
+
+// src/commands/status.ts
+import { defineCommand as defineCommand3 } from "citty";
+import { readFileSync as readFileSync3, existsSync as existsSync3 } from "fs";
+import { resolve as resolve3 } from "path";
+import { homedir as homedir3 } from "os";
+var isRunning3 = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var statusCommand = defineCommand3({
+  meta: {
+    name: "status",
+    description: "Show daemon status"
+  },
+  run() {
+    const dataDir = process.env["KINDFLOW_DATA_DIR"] ?? resolve3(homedir3(), ".kindflow");
+    const pidPath = resolve3(dataDir, "daemon.pid");
+    const logPath = resolve3(dataDir, "daemon.log");
+    if (!existsSync3(pidPath)) {
+      console.log("  Kindflow is not running.");
+      return;
+    }
+    const pid = parseInt(readFileSync3(pidPath, "utf-8").trim(), 10);
+    if (isNaN(pid) || !isRunning3(pid)) {
+      console.log("  Kindflow is not running (stale PID file).");
+      return;
     }
-    const paths = {
-      ...base,
-      webDir,
-      ...args.agentsDir ? { agentsDir: resolve(args.agentsDir) } : {}
-    };
-    mkdirSync(paths.agentsDir, { recursive: true });
-    const port = args.port ? parseInt(args.port, 10) : void 0;
-    const webPort = args.webPort ? parseInt(args.webPort, 10) : void 0;
     console.log("");
-    console.log("  Kindflow \u2014 The opinionated agent platform");
+    console.log("  Kindflow is running");
+    console.log("");
+    console.log(`  PID:     ${pid}`);
+    console.log(`  Data:    ${dataDir}`);
+    console.log(`  Agents:  ${resolve3(dataDir, "agents")}`);
+    console.log(`  Logs:    ${logPath}`);
     console.log("");
-    const daemon = await startDaemon({ port, webPort, paths });
-    const handleSignal = async (signal) => {
-      console.log(`
-[kindflow] Received ${signal}`);
-      await daemon.shutdown();
-      process.exit(0);
-    };
-    process.on("SIGINT", () => handleSignal("SIGINT"));
-    process.on("SIGTERM", () => handleSignal("SIGTERM"));
   }
 });
 
 // src/commands/create.ts
-import { defineCommand as defineCommand2 } from "citty";
-import { mkdirSync as mkdirSync2, existsSync } from "fs";
-import { resolve as resolve2 } from "path";
-var createCommand = defineCommand2({
+import { defineCommand as defineCommand4 } from "citty";
+import { mkdirSync as mkdirSync2, existsSync as existsSync4 } from "fs";
+import { resolve as resolve4 } from "path";
+var createCommand = defineCommand4({
   meta: {
     name: "create",
     description: "Create a new agent"
@@ -102,8 +338,8 @@ var createCommand = defineCommand2({
     const paths = resolvePaths();
     mkdirSync2(paths.agentsDir, { recursive: true });
     const slug = generateSlug(args.name);
-    const agentDir = resolve2(paths.agentsDir, slug);
-    if (existsSync(agentDir)) {
+    const agentDir = resolve4(paths.agentsDir, slug);
+    if (existsSync4(agentDir)) {
       console.error(`Agent "${slug}" already exists at ${agentDir}`);
       process.exit(1);
     }
@@ -113,8 +349,8 @@ var createCommand = defineCommand2({
 });
 
 // src/commands/list.ts
-import { defineCommand as defineCommand3 } from "citty";
-var listCommand = defineCommand3({
+import { defineCommand as defineCommand5 } from "citty";
+var listCommand = defineCommand5({
   meta: {
     name: "list",
     description: "List all agents"
@@ -137,14 +373,16 @@ var listCommand = defineCommand3({
 });
 
 // src/cli.ts
-var main = defineCommand4({
+var main = defineCommand6({
   meta: {
     name: "kindflow",
-    version: "0.3.0",
+    version: "0.4.0",
     description: "Kindflow \u2014 The opinionated agent platform"
   },
   subCommands: {
     start: startCommand,
+    stop: stopCommand,
+    status: statusCommand,
     create: createCommand,
     list: listCommand
   }