refactor: rename init command to run, simplify existing-project flow

The `run` command handles both new projects (scaffolding wizard) and
existing projects (launch dev UI). Existing project flow simplified to
just a launch mode selector. All references updated across CLI, skills,
and install instructions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: cevian

packages/core/src/cli/index.ts

@@ -15,7 +15,7 @@ import { getTrace, printTrace } from "./trace.js";
 import { getAppName } from "./app.js";
 import { startMcpServer } from "./mcp/server.js";
 import { runInstall, runUninstall } from "./install.js";
-import { runInit } from "./init.js";
+import { runRun } from "./run.js";
 
 // Read version from package.json
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -88,12 +88,12 @@ program
   .description("CLI for 0pflow workflow engine")
   .version(version);
 
-// ============ Init command ============
+// ============ Run command ============
 program
-  .command("init")
-  .description("Create a new 0pflow project")
+  .command("run")
+  .description("Create a new project or launch an existing one")
   .action(async () => {
-    await runInit();
+    await runRun();
   });
 
 // ============ Workflow commands ============

packages/core/src/cli/install.ts

@@ -228,8 +228,8 @@ export async function runInstall(options: InstallOptions = {}): Promise<void> {
 
   // Development mode: just show the command to use
   if (mcpResult.isLocal) {
-    // Build the init command from the MCP command (same tsx + script, different subcommand)
-    const initCmd = mcpResult.command.slice(0, -2).concat("init").join(" ");
+    // Build the run command from the MCP command (same tsx + script, different subcommand)
+    const initCmd = mcpResult.command.slice(0, -2).concat("run").join(" ");
 
     printBanner();
     console.log(pc.yellow("Development mode detected"));

packages/core/src/cli/init.ts packages/core/src/cli/run.tspackages/core/src/cli/init.ts renamed to packages/core/src/cli/run.ts

@@ -111,36 +111,32 @@ async function launchDevServer(cwd: string, { yolo = false }: { yolo?: boolean }
   }
 }
 
-export async function runInit(): Promise<void> {
-  p.intro(pc.red("0pflow") + pc.dim(" — create a new project"));
+export async function runRun(): Promise<void> {
+  p.intro(pc.red("0pflow"));
 
   if (!isClaudeAvailable()) {
     p.log.error("Claude Code CLI not found. Install it from https://claude.ai/code");
     process.exit(1);
   }
 
-  // ── Existing project check ──────────────────────────────────────────
+  // ── Existing project → launch ───────────────────────────────────────
   if (isExisting0pflow()) {
-    const action = await p.select({
-      message: "This directory is already an 0pflow project.",
+    const mode = await p.select({
+      message: "Launch mode",
       options: [
-        { value: "claude" as const, label: "Launch Dev UI" },
-        { value: "claude-yolo" as const, label: "Launch Dev UI with --dangerously-skip-permissions" },
-        { value: "new" as const, label: "Create a new project in a subdirectory" },
+        { value: "normal" as const, label: "Launch" },
+        { value: "yolo" as const, label: "Launch with --dangerously-skip-permissions" },
       ],
     });
 
-    if (p.isCancel(action)) {
+    if (p.isCancel(mode)) {
       p.cancel("Cancelled.");
       process.exit(0);
     }
 
-    if (action === "claude" || action === "claude-yolo") {
-      p.outro(pc.green("Launching Dev UI..."));
-      await launchDevServer(process.cwd(), { yolo: action === "claude-yolo" });
-      return;
-    }
-    // fall through to normal wizard (cwdEmpty will be false, so directory defaults to ./<name>)
+    p.outro(pc.green("Launching..."));
+    await launchDevServer(process.cwd(), { yolo: mode === "yolo" });
+    return;
   }
 
   const cwdEmpty = isCwdEmpty();
@@ -390,7 +386,7 @@ export async function runInit(): Promise<void> {
         } else {
           s.stop(pc.yellow("Database not ready yet"));
           p.log.warn(
-            `Run later: 0pflow init won't retry. Use the MCP tools or set up manually.`,
+            `Run later: 0pflow run won't retry. Use the MCP tools or set up manually.`,
           );
         }
       } else {
@@ -400,19 +396,19 @@ export async function runInit(): Promise<void> {
     }
   }
 
-  // ── Launch Dev UI? ──────────────────────────────────────────────────
+  // ── Launch? ─────────────────────────────────────────────────────────
   const launchChoice = await p.select({
-    message: "Launch Dev UI to design your first workflow?",
+    message: "Launch now?",
     options: [
-      { value: "claude" as const, label: "Yes" },
-      { value: "claude-yolo" as const, label: "Yes, with --dangerously-skip-permissions" },
+      { value: "normal" as const, label: "Yes" },
+      { value: "yolo" as const, label: "Yes, with --dangerously-skip-permissions" },
       { value: "no" as const, label: "No, I'll do it later" },
     ],
   });
 
   if (!p.isCancel(launchChoice) && launchChoice !== "no") {
-    p.outro(pc.green("Launching Dev UI..."));
-    await launchDevServer(resolve(appPath), { yolo: launchChoice === "claude-yolo" });
+    p.outro(pc.green("Launching..."));
+    await launchDevServer(resolve(appPath), { yolo: launchChoice === "yolo" });
     return;
   }
 
@@ -421,7 +417,7 @@ export async function runInit(): Promise<void> {
 
   p.outro(pc.green("Project created!"));
   console.log();
-  console.log(pc.bold("  To launch the Dev UI later:"));
-  console.log(pc.cyan(`  ${cdCmd}0pflow dev`));
+  console.log(pc.bold("  To launch later:"));
+  console.log(pc.cyan(`  ${cdCmd}0pflow run`));
   console.log();
 }

skills/create-workflow/SKILL.md

@@ -16,13 +16,13 @@ Design and write a workflow with embedded description fields for 0pflow.
 Check the current working directory and handle one of three cases:
 
 **Case 1: Empty directory** (no files, or only dotfiles like `.git`)
-→ Tell the user to run `0pflow init` first to scaffold a new project, then re-invoke this skill. **Stop here.**
+→ Tell the user to run `0pflow run` first to scaffold a new project, then re-invoke this skill. **Stop here.**
 
 **Case 2: Existing 0pflow project** (has `generated/workflows/` or `specs/agents/` directories)
 → Good to go. Continue to step 2.
 
 **Case 3: Existing non-0pflow directory** (has files/projects but no 0pflow structure — e.g., home directory, another repo)
-→ Tell the user to run `0pflow init` in a subdirectory first, then re-invoke this skill from inside that directory. **Stop here.**
+→ Tell the user to run `0pflow run` in a subdirectory first, then re-invoke this skill from inside that directory. **Stop here.**
 
 ### 2. Discover Integrations