@codegrammer/co-od 0.1.3 → 0.1.5

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function run(args: string[]): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,168 @@
+import * as api from "../api-client.js";
+import { getAdapter } from "../adapters/index.js";
+import { writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join, basename } from "node:path";
+import { homedir } from "node:os";
+function parseArgs(args) {
+    const parsed = {
+        dir: process.cwd(),
+        provider: "claude",
+    };
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--dir" && args[i + 1]) {
+            parsed.dir = args[++i];
+        }
+        else if (args[i] === "--name" && args[i + 1]) {
+            parsed.name = args[++i];
+        }
+        else if (args[i] === "--provider" && args[i + 1]) {
+            parsed.provider = args[++i];
+        }
+        else if (args[i] === "--server" && args[i + 1]) {
+            parsed.server = args[++i];
+        }
+        else if (!args[i].startsWith("--") && !parsed.name) {
+            parsed.name = args[i];
+        }
+    }
+    return parsed;
+}
+function timestamp() {
+    return new Date().toISOString().slice(11, 19);
+}
+export async function run(args) {
+    if (args.includes("--help") || args.includes("-h")) {
+        console.error(`Usage: co-od init [name] [--dir <path>] [--provider claude|codex|openclaw]
+
+Sets up a new co-ode project:
+  1. Creates a room on co-od.dev
+  2. Links it to your local project directory
+  3. Adds a default agent
+  4. Generates a .co-od config file
+  5. Ready to go — start giving tasks
+
+Examples:
+  co-od init                          # Uses current dir name as room name
+  co-od init "my-saas-app"            # Custom room name
+  co-od init --provider codex         # Use Codex as default agent
+  co-od init --dir ~/projects/app     # Different directory
+`);
+        process.exit(0);
+    }
+    const parsed = parseArgs(args);
+    if (parsed.server) {
+        process.env.CO_ODE_SERVER = parsed.server;
+    }
+    // Ensure logged in
+    const token = api.getSessionToken();
+    if (!token) {
+        console.error(`[${timestamp()}] Not logged in. Run: co-od login`);
+        process.exit(1);
+    }
+    const projectDir = parsed.dir;
+    const roomName = parsed.name || basename(projectDir);
+    console.error(`\n  co-od init\n`);
+    console.error(`  project:  ${projectDir}`);
+    console.error(`  room:     ${roomName}`);
+    console.error(`  provider: ${parsed.provider}\n`);
+    // Step 1: Check provider is available
+    console.error(`  [1/5] Checking ${parsed.provider} CLI...`);
+    const adapter = getAdapter(parsed.provider);
+    const available = await adapter.available();
+    if (!available) {
+        console.error(`        ✗ ${adapter.name} not found on PATH`);
+        console.error(`        Install it first, then run co-od init again.`);
+        process.exit(1);
+    }
+    console.error(`        ✓ ${adapter.name} available`);
+    // Step 2: Create room
+    console.error(`  [2/5] Creating room "${roomName}"...`);
+    let roomId;
+    try {
+        const res = await api.post("/api/rooms", { name: roomName });
+        roomId = res.roomId || res.room?._id || "";
+        if (!roomId)
+            throw new Error("No room ID returned");
+        console.error(`        ✓ Room created: ${roomId.slice(0, 12)}...`);
+    }
+    catch (err) {
+        console.error(`        ✗ Failed to create room: ${err}`);
+        process.exit(1);
+    }
+    // Step 3: Add default agent
+    console.error(`  [3/5] Adding default agent...`);
+    let agentId;
+    try {
+        const agentName = parsed.provider === "codex" ? "Codex Builder"
+            : parsed.provider === "openclaw" ? "OpenClaw Agent"
+                : "Claude Builder";
+        const res = await api.post(`/api/rooms/${roomId}/agents`, {
+            name: agentName,
+            type: "builder",
+            executionMode: parsed.provider === "codex" ? "local_codex" : "local_claude_code",
+            provider: parsed.provider === "codex" ? "openai"
+                : parsed.provider === "openclaw" ? "openclaw"
+                    : "anthropic",
+            permissions: {
+                "fs.read": true,
+                "fs.write": true,
+                "fs.applyPatch": true,
+                "exec.run": true,
+                "net.egress": false,
+                "ports.expose": false,
+                "secrets.read": false,
+            },
+        });
+        agentId = res.agentId || "";
+        console.error(`        ✓ Agent "${agentName}" added`);
+    }
+    catch (err) {
+        console.error(`        ✗ Failed to add agent: ${err}`);
+        agentId = "";
+    }
+    // Step 4: Save config
+    console.error(`  [4/5] Saving config...`);
+    const config = {
+        roomId,
+        roomName,
+        projectDir,
+        provider: parsed.provider,
+        agentId,
+        server: api.getBaseUrl(),
+        createdAt: new Date().toISOString(),
+    };
+    // Save to project dir
+    const configPath = join(projectDir, ".co-od.json");
+    try {
+        writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+        console.error(`        ✓ ${configPath}`);
+    }
+    catch {
+        console.error(`        ✗ Could not write ${configPath}`);
+    }
+    // Also save room mapping to global config
+    const globalConfigDir = join(homedir(), ".co-od");
+    const roomsMapPath = join(globalConfigDir, "rooms.json");
+    try {
+        mkdirSync(globalConfigDir, { recursive: true });
+        let rooms = {};
+        if (existsSync(roomsMapPath)) {
+            rooms = JSON.parse(require("node:fs").readFileSync(roomsMapPath, "utf-8"));
+        }
+        rooms[roomId] = { roomId, projectDir, name: roomName };
+        writeFileSync(roomsMapPath, JSON.stringify(rooms, null, 2) + "\n", "utf-8");
+    }
+    catch {
+        // Non-fatal
+    }
+    // Step 5: Done
+    console.error(`  [5/5] Ready!\n`);
+    console.error(`  Your room is live. Next steps:\n`);
+    console.error(`    co-od run ${roomId.slice(0, 12)} "describe your task"   # run a single task`);
+    console.error(`    co-od daemon ${roomId.slice(0, 12)} --auto-execute       # autonomous mode`);
+    console.error(`    co-od share                                    # invite teammates\n`);
+    console.error(`  Or open in browser:`);
+    console.error(`    ${api.getBaseUrl()}/rooms/${roomId}\n`);
+    // Output JSON for scripting
+    console.log(JSON.stringify(config, null, 2));
+}

package/dist/commands/start.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `npx co-od` (no args) — the zero-config magic start.
+ *
+ * 1. Check login → open browser if needed
+ * 2. Detect project dir + available CLIs
+ * 3. Find or create room for this project
+ * 4. Start local bridge in background
+ * 5. Open browser to room
+ * 6. Done — user types a task in the browser
+ */
+export declare function run(_args: string[]): Promise<void>;

package/dist/commands/start.js

@@ -0,0 +1,240 @@
+/**
+ * `npx co-od` (no args) — the zero-config magic start.
+ *
+ * 1. Check login → open browser if needed
+ * 2. Detect project dir + available CLIs
+ * 3. Find or create room for this project
+ * 4. Start local bridge in background
+ * 5. Open browser to room
+ * 6. Done — user types a task in the browser
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { join, basename } from "node:path";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
+import * as api from "../api-client.js";
+import { getAdapter } from "../adapters/index.js";
+function log(msg) {
+    console.error(`  ${msg}`);
+}
+function detectProvider() {
+    // Check what's available, prefer claude > codex > openclaw
+    const checks = [
+        { name: "claude", bin: "claude" },
+        { name: "codex", bin: "codex" },
+        { name: "openclaw", bin: "zeroclaw" },
+        { name: "openclaw", bin: "openclaw" },
+    ];
+    const paths = (process.env.PATH || "").split(":");
+    for (const { name, bin } of checks) {
+        if (paths.some((dir) => existsSync(join(dir, bin))))
+            return name;
+    }
+    return "claude"; // default, will fail with helpful message later
+}
+async function ensureLoggedIn() {
+    const token = api.getSessionToken();
+    if (token)
+        return true;
+    log("Not logged in. Opening browser...\n");
+    // Run login command
+    const { run: loginRun } = await import("./login.js");
+    await loginRun([]);
+    // Check again
+    return !!api.getSessionToken();
+}
+function findExistingConfig(dir) {
+    const configPath = join(dir, ".co-od.json");
+    if (!existsSync(configPath))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(configPath, "utf-8"));
+        if (data.roomId)
+            return { roomId: data.roomId, roomName: data.roomName || basename(dir) };
+    }
+    catch { /* ignore */ }
+    return null;
+}
+function startBridgeBackground() {
+    // Check if bridge is already running
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 1000);
+        // Can't use fetch synchronously, so spawn a quick check
+        const check = spawn("sh", ["-c", "curl -sf http://127.0.0.1:4786/health > /dev/null 2>&1"], {
+            stdio: "ignore",
+        });
+        check.on("close", (code) => {
+            clearTimeout(timeout);
+            if (code === 0) {
+                log("✓ local bridge already running");
+                return;
+            }
+            // Not running — start it
+            spawnBridge();
+        });
+        check.on("error", () => {
+            clearTimeout(timeout);
+            spawnBridge();
+        });
+    }
+    catch {
+        spawnBridge();
+    }
+}
+function spawnBridge() {
+    // Find the bridge script — check common locations
+    const possiblePaths = [
+        join(process.cwd(), "services/local-bridge/src/index.ts"),
+        join(process.cwd(), "node_modules/.bin/co-od-bridge"),
+        // Monorepo structure
+        join(process.cwd(), "../../services/local-bridge/src/index.ts"),
+    ];
+    // For now, just try to start via the co-ode monorepo if we're in it
+    const monorepoRoot = findMonorepoRoot(process.cwd());
+    if (monorepoRoot) {
+        const bridgePath = join(monorepoRoot, "services/local-bridge/src/index.ts");
+        if (existsSync(bridgePath)) {
+            const child = spawn("npx", ["ts-node", "--transpile-only", bridgePath], {
+                cwd: join(monorepoRoot, "services/local-bridge"),
+                stdio: "ignore",
+                detached: true,
+                env: { ...process.env, LOCAL_BRIDGE_PROJECT_ROOT: process.cwd() },
+            });
+            child.unref();
+            log("✓ local bridge started in background (port 4786)");
+            return;
+        }
+    }
+    log("⚠ local bridge not started — run your bridge manually or install the co-od bridge package");
+}
+function findMonorepoRoot(from) {
+    let dir = from;
+    for (let i = 0; i < 5; i++) {
+        if (existsSync(join(dir, "services/local-bridge")))
+            return dir;
+        const parent = join(dir, "..");
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+async function openBrowser(url) {
+    try {
+        const open = (await import("open")).default;
+        await open(url);
+    }
+    catch {
+        log(`Open in browser: ${url}`);
+    }
+}
+export async function run(_args) {
+    const dir = process.cwd();
+    const projectName = basename(dir);
+    console.error(`
+  ┌─────────────────────────────┐
+  │         co-od               │
+  │   agents + humans,          │
+  │   one workspace             │
+  └─────────────────────────────┘
+`);
+    // Step 1: Login
+    log("[1/5] Checking authentication...");
+    const loggedIn = await ensureLoggedIn();
+    if (!loggedIn) {
+        log("✗ Login required. Run: co-od login");
+        process.exit(1);
+    }
+    log("✓ logged in\n");
+    // Step 2: Detect environment
+    log("[2/5] Detecting environment...");
+    const provider = detectProvider();
+    const adapter = getAdapter(provider);
+    const available = await adapter.available();
+    if (available) {
+        log(`✓ ${adapter.name} CLI available`);
+    }
+    else {
+        log(`⚠ no agent CLI found — install Claude Code, Codex, or ZeroClaw`);
+        log(`  brew install claude    (or)    npm install -g @openai/codex`);
+    }
+    log(`✓ project: ${dir}\n`);
+    // Step 3: Find or create room
+    log("[3/5] Setting up room...");
+    const existing = findExistingConfig(dir);
+    let roomId;
+    let roomName;
+    if (existing) {
+        roomId = existing.roomId;
+        roomName = existing.roomName;
+        log(`✓ found existing room: ${roomName}`);
+    }
+    else {
+        // Create new room
+        roomName = projectName;
+        try {
+            const res = await api.post("/api/rooms", { name: roomName });
+            roomId = res.roomId || res.room?._id || "";
+            if (!roomId)
+                throw new Error("No room ID");
+            log(`✓ room created: ${roomName}`);
+            // Add default agent
+            const agentName = provider === "codex" ? "Codex Builder"
+                : provider === "openclaw" ? "OpenClaw Agent"
+                    : "Claude Builder";
+            try {
+                await api.post(`/api/rooms/${roomId}/agents`, {
+                    name: agentName,
+                    type: "builder",
+                    executionMode: provider === "codex" ? "local_codex" : "local_claude_code",
+                    provider: provider === "codex" ? "openai" : provider === "openclaw" ? "openclaw" : "anthropic",
+                    permissions: { "fs.read": true, "fs.write": true, "fs.applyPatch": true, "exec.run": true, "net.egress": false, "ports.expose": false, "secrets.read": false },
+                });
+                log(`✓ agent "${agentName}" added`);
+            }
+            catch {
+                log(`⚠ could not add agent (add one manually in the UI)`);
+            }
+            // Save config
+            const config = { roomId, roomName, projectDir: dir, provider, server: api.getBaseUrl(), createdAt: new Date().toISOString() };
+            try {
+                writeFileSync(join(dir, ".co-od.json"), JSON.stringify(config, null, 2) + "\n");
+                log(`✓ config saved: .co-od.json`);
+            }
+            catch { /* non-fatal */ }
+            // Save to global rooms map
+            try {
+                const globalDir = join(homedir(), ".co-od");
+                mkdirSync(globalDir, { recursive: true });
+                const mapPath = join(globalDir, "rooms.json");
+                let rooms = {};
+                if (existsSync(mapPath))
+                    rooms = JSON.parse(readFileSync(mapPath, "utf-8"));
+                rooms[roomId] = { roomId, projectDir: dir, name: roomName };
+                writeFileSync(mapPath, JSON.stringify(rooms, null, 2) + "\n");
+            }
+            catch { /* non-fatal */ }
+        }
+        catch (err) {
+            log(`✗ failed to create room: ${err}`);
+            process.exit(1);
+        }
+    }
+    console.error("");
+    // Step 4: Start bridge
+    log("[4/5] Starting local bridge...");
+    startBridgeBackground();
+    console.error("");
+    // Step 5: Open browser
+    log("[5/5] Opening workspace...\n");
+    const url = `${api.getBaseUrl()}/rooms/${roomId}`;
+    await openBrowser(url);
+    console.error(`  ✓ Ready! Your workspace is open at:`);
+    console.error(`    ${url}\n`);
+    console.error(`  Type a task in the browser to get started.`);
+    console.error(`  Or use the CLI:\n`);
+    console.error(`    co-od run ${roomId.slice(0, 12)} "your task here"`);
+    console.error(`    co-od daemon ${roomId.slice(0, 12)} --auto-execute`);
+    console.error(`    co-od share\n`);
+}

package/dist/index.js

@@ -2,11 +2,12 @@
 "use strict";
 const VERSION = "0.1.0";
 const COMMANDS = {
+    init: { desc: "Set up a new co-ode project", usage: "co-od init [name] [--dir <path>] [--provider claude|codex|openclaw]" },
     login: { desc: "Authenticate with co-ode", usage: "co-od login [--token <t>]" },
     rooms: { desc: "List your rooms", usage: "co-od rooms [--json]" },
     run: { desc: "Execute a single task in a room", usage: "co-od run <room> <goal> [--provider claude|codex|openclaw] [--dir <path>] [--json]" },
     join: { desc: "Join a room as an interactive agent", usage: "co-od join <room> [--invite-token <tok>] [--dir <path>]" },
-    daemon: { desc: "Autonomous watch mode for a room", usage: "co-od daemon <room> [--as <name>] [--auto-execute] [--watch <events>]" },
+    daemon: { desc: "Autonomous watch mode for a room", usage: "co-od daemon <room> [--as <name>] [--auto-execute] [--handoff-to <agent>]" },
     share: { desc: "Generate a relay code for teammates", usage: "co-od share [--provider claude|codex|openclaw]" },
     connect: { desc: "Connect to a relay via code", usage: "co-od connect <code>" },
     status: { desc: "Show current login and running state", usage: "co-od status [--json]" },
@@ -37,10 +38,16 @@ async function main() {
         console.log(VERSION);
         process.exit(0);
     }
-    if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+    if (args.includes("--help") || args.includes("-h")) {
         printHelp();
         process.exit(0);
     }
+    // No args = magic zero-config start
+    if (args.length === 0) {
+        const { run } = await import("./commands/start.js");
+        await run([]);
+        return;
+    }
     const command = args[0];
     const commandArgs = args.slice(1);
     // Show command-specific help
@@ -58,6 +65,11 @@ async function main() {
     }
     // Route to command
     switch (command) {
+        case "init": {
+            const { run } = await import("./commands/init.js");
+            await run(commandArgs);
+            break;
+        }
         case "login": {
             const { run } = await import("./commands/login.js");
             await run(commandArgs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codegrammer/co-od",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI for co-ode \u2014 run AI agents in shared rooms from the command line",
   "type": "module",
   "bin": {