@intend-it/cli 1.3.0 → 1.3.1

package/README.md

@@ -2,6 +2,7 @@
   <h1>@intend-it/cli</h1>
   <p><strong>Command-Line Interface for the Intend Programming Language</strong></p>
   <p>
+    <a href="https://intend.fly.dev">Documentation</a> •
     <a href="https://www.npmjs.com/package/@intend-it/cli"><img src="https://img.shields.io/npm/v/@intend-it/cli.svg" alt="npm version"></a>
     <a href="https://www.npmjs.com/package/@intend-it/cli"><img src="https://img.shields.io/npm/dm/@intend-it/cli.svg" alt="npm downloads"></a>
     <a href="https://github.com/DRFR0ST/intend/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@intend-it/cli.svg" alt="license"></a>
@@ -14,6 +15,8 @@
 
 The official CLI for building **Intend** projects. Write your intentions, let AI generate the code.
 
+**[Read the full documentation 📖](https://intend.fly.dev)**
+
 ### ✨ Features
 
 - **🚀 Zero Config** - Works out of the box with sensible defaults

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/commands/init.ts
-import { existsSync as existsSync2, mkdirSync, writeFileSync as writeFileSync2 } from "fs";
+import { existsSync as existsSync2, mkdirSync, writeFileSync as writeFileSync2, readdirSync } from "fs";
 import { join as join2, resolve as resolve2 } from "path";
 
 // src/config.ts
@@ -54,16 +54,247 @@ function loadConfig(configPath) {
     throw new Error(`Failed to parse config file: ${error.message}`);
   }
 }
-function createConfigFile(directory = process.cwd()) {
+function createConfigFile(directory = process.cwd(), configOverwrites) {
   const path = join(directory, DEFAULT_CONFIG_NAME);
   if (existsSync(path)) {
     throw new Error(`Config file already exists: ${path}`);
   }
-  writeFileSync(path, JSON.stringify(DEFAULT_CONFIG, null, 2), "utf-8");
+  const config = {
+    ...DEFAULT_CONFIG,
+    ...configOverwrites,
+    gemini: { ...DEFAULT_CONFIG.gemini, ...configOverwrites?.gemini || {} },
+    ollama: { ...DEFAULT_CONFIG.ollama, ...configOverwrites?.ollama || {} }
+  };
+  writeFileSync(path, JSON.stringify(config, null, 2), "utf-8");
 }
 
-// src/ui.ts
+// src/commands/init.ts
+import * as p from "@clack/prompts";
 import pc from "picocolors";
+async function initCommand(args) {
+  const skipInteractive = args.includes("-y") || args.includes("--yes");
+  if (!skipInteractive) {
+    p.intro(`${pc.bgCyan(pc.black(" Intend Init "))} ${pc.dim("Set up your project")}`);
+  }
+  let projectName = args.find((a) => !a.startsWith("-") && a !== "init");
+  if (!projectName) {
+    if (skipInteractive) {
+      projectName = ".";
+    } else {
+      projectName = await p.text({
+        message: "What is your project name?",
+        placeholder: "my-intend-app",
+        validate: (value) => {
+          if (!value)
+            return "Please enter a name";
+          if (value.match(/[^a-zA-Z0-9-_]/))
+            return "Name can only contain letters, numbers, dashes and underscores";
+        }
+      });
+      if (p.isCancel(projectName)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+      }
+    }
+  }
+  const directory = resolve2(process.cwd(), projectName);
+  if (!skipInteractive && existsSync2(directory) && readdirSync(directory).length > 0) {
+    const confirm2 = await p.confirm({
+      message: `Directory ${pc.cyan(projectName)} is not empty. Continue anyway?`,
+      initialValue: false
+    });
+    if (p.isCancel(confirm2) || !confirm2) {
+      p.cancel("Operation cancelled");
+      process.exit(0);
+    }
+  }
+  let provider = "gemini";
+  let configOverwrites = {};
+  if (!skipInteractive) {
+    provider = await p.select({
+      message: "Which AI provider would you like to use?",
+      options: [
+        { value: "gemini", label: "Google Gemini", hint: "Recommended" },
+        { value: "ollama", label: "Ollama", hint: "Local execution" }
+      ]
+    });
+    if (p.isCancel(provider)) {
+      p.cancel("Operation cancelled");
+      process.exit(0);
+    }
+    configOverwrites.provider = provider;
+    if (provider === "gemini") {
+      const model = await p.select({
+        message: "Select a Gemini model",
+        options: [
+          { value: "gemini-3-flash-preview", label: "Gemini 3 Flash", hint: "State of the art (Preview)" },
+          { value: "gemini-3-pro-preview", label: "Gemini 3 Pro", hint: "Most capable (Preview)" },
+          { value: "gemini-2.5-pro", label: "Gemini 2.5 Pro", hint: "Most capable" },
+          { value: "gemini-2.5-flash", label: "Gemini 2.5 Flash", hint: "Current frontier" },
+          { value: "gemini-2.5-flash-lite", label: "Gemini 2.5 Flash Lite", hint: "Fast and reliable" },
+          { value: "other", label: "Other (specify)" }
+        ]
+      });
+      if (p.isCancel(model)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      let finalModel = model;
+      if (model === "other") {
+        finalModel = await p.text({
+          message: "Enter the model name",
+          placeholder: "gemini-2.5-flash-lite"
+        });
+        if (p.isCancel(finalModel)) {
+          p.cancel("Operation cancelled");
+          process.exit(0);
+        }
+      }
+      const apiKey = await p.text({
+        message: "Enter your Gemini API Key (optional)",
+        placeholder: "Leave empty to use GEMINI_API_KEY env var"
+      });
+      if (p.isCancel(apiKey)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      configOverwrites.gemini = {
+        apiKey: apiKey || "${GEMINI_API_KEY}",
+        model: finalModel
+      };
+    } else {
+      const baseUrl = await p.text({
+        message: "Ollama Base URL",
+        initialValue: "http://localhost:11434"
+      });
+      if (p.isCancel(baseUrl)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      let localModels = [];
+      const sFetch = p.spinner();
+      sFetch.start("Fetching local Ollama models...");
+      try {
+        const response = await fetch(`${baseUrl.replace(/\/$/, "")}/api/tags`);
+        if (response.ok) {
+          const data = await response.json();
+          if (data.models && Array.isArray(data.models)) {
+            localModels = data.models.map((m) => ({
+              value: m.name,
+              label: m.name
+            }));
+          }
+        }
+        sFetch.stop(localModels.length > 0 ? "Fetched local models" : "No local models found");
+      } catch (e) {
+        sFetch.stop("Could not connect to Ollama (using fallback list)");
+      }
+      const options = localModels.length > 0 ? [...localModels, { value: "other", label: "Other (specify)" }] : [
+        { value: "llama3.2", label: "Llama 3.2" },
+        { value: "mistral", label: "Mistral" },
+        { value: "gemma3:4b", label: "Gemma 3 4B" },
+        { value: "codegemma", label: "CodeGemma" },
+        { value: "other", label: "Other (specify)" }
+      ];
+      const model = await p.select({
+        message: "Select an Ollama model",
+        options
+      });
+      if (p.isCancel(model)) {
+        p.cancel("Operation cancelled");
+        process.exit(0);
+      }
+      let finalModel = model;
+      if (model === "other") {
+        finalModel = await p.text({
+          message: "Enter the model name",
+          placeholder: "deepseek-coder"
+        });
+        if (p.isCancel(finalModel)) {
+          p.cancel("Operation cancelled");
+          process.exit(0);
+        }
+      }
+      configOverwrites.ollama = {
+        model: finalModel,
+        baseUrl
+      };
+    }
+  }
+  const s = p.spinner();
+  s.start("Initializing project...");
+  if (!existsSync2(directory)) {
+    mkdirSync(directory, { recursive: true });
+  }
+  const srcDir = join2(directory, "src");
+  const intentsDir = join2(srcDir, "intents");
+  if (!existsSync2(intentsDir)) {
+    mkdirSync(intentsDir, { recursive: true });
+  }
+  const outDir = join2(directory, "out");
+  if (!existsSync2(outDir)) {
+    mkdirSync(outDir, { recursive: true });
+  }
+  try {
+    createConfigFile(directory, configOverwrites);
+  } catch (error) {
+    s.stop(`${pc.red("Error:")} ${error.message}`);
+    process.exit(1);
+  }
+  const typesPath = join2(srcDir, "types.ts");
+  if (!existsSync2(typesPath)) {
+    const typesContent = `export interface User {
+  name: string;
+  id: number;
+  createdAt: Date;
+}`;
+    writeFileSync2(typesPath, typesContent, "utf-8");
+  }
+  const examplePath = join2(intentsDir, "example.intent");
+  if (!existsSync2(examplePath)) {
+    const exampleContent = `import { User } from "../types";
+
+export intent CreateUser(name: string) -> User {
+    step "Generate a random ID" => const id
+    step "Create a User object with name, id, and current date" => const user
+    return user
+}
+
+export entry intent Main() -> void {
+    step "Call CreateUser with name 'Intender'" => const user
+    step "Log 'Created user:' and the user object to console"
+}
+`;
+    writeFileSync2(examplePath, exampleContent, "utf-8");
+  }
+  const gitignorePath = join2(directory, ".gitignore");
+  if (!existsSync2(gitignorePath)) {
+    const gitignoreContent = `node_modules/
+dist/
+out/
+.intend/
+.env
+.DS_Store
+`;
+    writeFileSync2(gitignorePath, gitignoreContent, "utf-8");
+  }
+  s.stop(pc.green("Project initialized successfully!"));
+  p.note(`${pc.white("1.")} cd ${pc.cyan(pc.bold(projectName))}
+` + `${pc.white("2.")} ${provider === "gemini" ? "Set " + pc.cyan(pc.bold("GEMINI_API_KEY")) + " in .env or shell" : "Ensure " + pc.cyan(pc.bold("Ollama")) + " is running"}
+` + `${pc.white("3.")} RUN ${pc.cyan(pc.bold("intend build"))} to generate code`, "Next Steps");
+  p.outro(`Happy coding with ${pc.cyan("Intend")}! ✨`);
+}
+
+// src/commands/build.ts
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, readFileSync as readFileSync2, copyFileSync } from "fs";
+import { execSync } from "child_process";
+import { join as join3, resolve as resolve3, dirname, basename } from "path";
+import { AICodeGenerator, FileSystemCAS, computeHash, OllamaProvider } from "@intend-it/core";
+import { parseToAST } from "@intend-it/parser";
+import { readdirSync as readdirSync2, statSync } from "fs";
+
+// src/ui.ts
+import pc2 from "picocolors";
 import ora from "ora";
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
@@ -72,36 +303,31 @@ var BRAND = {
   name: "intend",
   version: pkg.version
 };
-var heading = (text) => pc.bold(text);
-var success = (text) => pc.green(text);
-var error = (text) => pc.red(text);
-var warn = (text) => pc.yellow(text);
-var accent = (text) => pc.cyan(text);
-var dim = (text) => pc.dim(text);
-var bullet = (text) => `  ${dim("›")} ${text}`;
-var path = (p) => dim(p);
-var num = (n) => pc.bold(pc.white(String(n)));
+var heading = (text2) => pc2.bold(text2);
+var error = (text2) => pc2.red(text2);
+var dim = (text2) => pc2.dim(text2);
+var path = (p2) => dim(p2);
 var duration = (ms) => dim(`${(ms / 1000).toFixed(2)}s`);
-var cmd = (name) => pc.cyan(name);
+var cmd = (name) => pc2.cyan(name);
 var label = (name, value) => `${dim(name + ":")} ${value}`;
 var icons = {
-  success: pc.green("✓"),
-  error: pc.red("✗"),
-  warning: pc.yellow("!"),
-  info: pc.cyan("i"),
-  cached: pc.blue("⚡"),
+  success: pc2.green("✓"),
+  error: pc2.red("✗"),
+  warning: pc2.yellow("!"),
+  info: pc2.cyan("i"),
+  cached: pc2.blue("⚡"),
   arrow: dim("→")
 };
-function spinner(text) {
+function spinner2(text2) {
   return ora({
-    text,
+    text: text2,
     color: "cyan",
     spinner: "dots"
   });
 }
-function printHeader(text) {
+function printHeader(text2) {
   console.log();
-  console.log(heading(text));
+  console.log(heading(text2));
 }
 function printError(message, detail) {
   console.log();
@@ -110,12 +336,6 @@ function printError(message, detail) {
     console.log(`  ${dim(detail)}`);
   }
 }
-function printSuccess(message) {
-  console.log(`${icons.success} ${success(message)}`);
-}
-function printWarning(message) {
-  console.log(`${icons.warning} ${warn(message)}`);
-}
 function newline() {
   console.log();
 }
@@ -128,7 +348,7 @@ function printHelp() {
   console.log(`  ${dim("$")} intend ${dim("<command>")} ${dim("[options]")}`);
   console.log();
   console.log(heading("Commands"));
-  console.log(`  ${cmd("init")} ${dim("[dir]")}        Initialize a new project`);
+  console.log(`  ${cmd("init")} ${dim("[dir] [--yes]")}  Initialize a new project`);
   console.log(`  ${cmd("build")}              Build the project`);
   console.log(`  ${cmd("watch")}              Watch and rebuild on changes`);
   console.log(`  ${cmd("parse")} ${dim("<file>")}      Parse a file to AST/CST`);
@@ -145,96 +365,11 @@ function printHelp() {
   console.log();
 }
 
-// src/commands/init.ts
-async function initCommand(args) {
-  const directory = args[1] ? resolve2(process.cwd(), args[1]) : process.cwd();
-  printHeader("Initialize Project");
-  console.log(label("Directory", path(directory)));
-  newline();
-  const spinner2 = spinner("Creating project structure...").start();
-  if (!existsSync2(directory)) {
-    mkdirSync(directory, { recursive: true });
-  }
-  const srcDir = join2(directory, "src", "intents");
-  if (!existsSync2(srcDir)) {
-    mkdirSync(srcDir, { recursive: true });
-  }
-  const outDir = join2(directory, "out");
-  if (!existsSync2(outDir)) {
-    mkdirSync(outDir, { recursive: true });
-  }
-  spinner2.succeed(dim("Project structure created"));
-  console.log(bullet(`${dim("src/intents/")} ${dim("(intent files)")}`));
-  console.log(bullet(`${dim("out/")} ${dim("(generated code)")}`));
-  const configSpinner = spinner("Creating configuration...").start();
-  try {
-    createConfigFile(directory);
-    configSpinner.succeed(dim("intend.config.json created"));
-  } catch (error2) {
-    configSpinner.stopAndPersist({
-      symbol: icons.warning,
-      text: warn(error2.message)
-    });
-  }
-  const typesPath = join2(srcDir, "types.ts");
-  if (!existsSync2(typesPath)) {
-    const typesContent = `export interface User {
-  name: string;
-  id: number;
-  createdAt: Date;
-}`;
-    writeFileSync2(typesPath, typesContent, "utf-8");
-    console.log(bullet(`${dim("src/intents/types.ts")} ${dim("(typescript definition)")}`));
-  }
-  const examplePath = join2(srcDir, "example.intent");
-  if (!existsSync2(examplePath)) {
-    const exampleContent = `import { User } from "./types";
-
-export intent CreateUser(name: string) -> User {
-    step "Generate a random ID" => const id
-    step "Create a User object with name, id, and current date" => const user
-    return user
-}
-
-export entry intent Main() -> void {
-    step "Call CreateUser with name 'Intender'" => const user
-    step "Log 'Created user:' and the user object to console"
-}
-`;
-    writeFileSync2(examplePath, exampleContent, "utf-8");
-    console.log(bullet(`${dim("src/intents/example.intent")} ${dim("(example intent)")}`));
-  }
-  const gitignorePath = join2(directory, ".gitignore");
-  if (!existsSync2(gitignorePath)) {
-    const gitignoreContent = `node_modules/
-dist/
-out/
-.intend/
-.env
-.DS_Store
-`;
-    writeFileSync2(gitignorePath, gitignoreContent, "utf-8");
-    console.log(bullet(`${dim(".gitignore")} ${dim("(git config)")}`));
-  }
-  newline();
-  printSuccess("Project initialized");
-  newline();
-  console.log(heading("Next Steps"));
-  console.log(bullet(`Configure provider in ${accent("intend.config.json")}`));
-  console.log(bullet(`Set ${accent("GEMINI_API_KEY")} env var ${dim("(if using Gemini)")}`));
-  console.log(bullet(`Run ${accent("intend build")} to generate code`));
-  newline();
-}
-
 // src/commands/build.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, readFileSync as readFileSync2, copyFileSync } from "fs";
-import { join as join3, resolve as resolve3, dirname, basename } from "path";
-import { AICodeGenerator, FileSystemCAS, computeHash, OllamaProvider } from "@intend-it/core";
-import * as readline from "readline";
-import { parseToAST } from "@intend-it/parser";
-import { readdirSync, statSync } from "fs";
+import * as p2 from "@clack/prompts";
+import pc3 from "picocolors";
 function findIntentFiles(dir, fileList = []) {
-  const files = readdirSync(dir);
+  const files = readdirSync2(dir);
   files.forEach((file) => {
     const filePath = join3(dir, file);
     const stat = statSync(filePath);
@@ -255,7 +390,7 @@ function copyResources(src, dest) {
     return;
   if (!existsSync3(dest))
     mkdirSync2(dest, { recursive: true });
-  const entries = readdirSync(src, { withFileTypes: true });
+  const entries = readdirSync2(src, { withFileTypes: true });
   for (const entry of entries) {
     const srcPath = join3(src, entry.name);
     const destPath = join3(dest, entry.name);
@@ -271,6 +406,10 @@ function copyResources(src, dest) {
   }
 }
 async function buildCommand(options) {
+  const isWatch = options.watch;
+  if (!isWatch) {
+    p2.intro(`${pc3.bgCyan(pc3.black(" Intend Build "))} ${pc3.dim("Generating TypeScript")}`);
+  }
   const config = loadConfig(options.config);
   if (options.output)
     config.outDir = options.output;
@@ -289,25 +428,33 @@ async function buildCommand(options) {
   const outDir = resolve3(process.cwd(), config.outDir);
   const providerName = config.provider || "gemini";
   if (config.provider === "gemini" && (!config.gemini || !config.gemini.apiKey)) {
-    printError("Gemini API key required", "Set GEMINI_API_KEY env var or add to intend.config.json");
+    if (isWatch) {
+      printError("Gemini API key required", "Set GEMINI_API_KEY env var or add to intend.config.json");
+    } else {
+      p2.cancel(`${pc3.red("Error:")} Gemini API key required. Set GEMINI_API_KEY env var or add to intend.config.json`);
+    }
     process.exit(1);
   }
-  printHeader("Build");
-  console.log(label("Source", path(sourceDir)));
-  console.log(label("Output", path(outDir)));
-  console.log(label("Provider", accent(providerName)));
-  newline();
-  const scanSpinner = spinner("Scanning for .intent files...").start();
+  const modelName = providerName === "ollama" ? config.ollama?.model || "llama3" : config.gemini?.model || "gemini-2.5-flash-lite";
+  if (!isWatch) {
+    console.log(`${pc3.dim("Source:   ")}${pc3.cyan(sourceDir)}`);
+    console.log(`${pc3.dim("Output:   ")}${pc3.cyan(outDir)}`);
+    console.log(`${pc3.dim("Provider: ")}${pc3.cyan(providerName)}`);
+    console.log(`${pc3.dim("Model:    ")}${pc3.cyan(modelName)}`);
+    console.log("");
+  }
+  const sFiles = p2.spinner();
+  sFiles.start("Scanning for .intent files...");
   let files = [];
   try {
     files = findIntentFiles(sourceDir);
-    scanSpinner.succeed(dim(`Found ${num(files.length)} intent file${files.length !== 1 ? "s" : ""}`));
+    sFiles.stop(`Found ${pc3.cyan(files.length)} intent files`);
   } catch (err) {
-    scanSpinner.fail(error(`Failed to scan ${sourceDir}`));
+    sFiles.stop("Failed to scan directory", 1);
     process.exit(1);
   }
   if (files.length === 0) {
-    printWarning("No .intent files found");
+    p2.log.warn("No .intent files found");
     return;
   }
   const startTime = Date.now();
@@ -322,8 +469,8 @@ async function buildCommand(options) {
       const hash = computeHash(content, config);
       fileData.set(file, { content, hash, ast: astResult.ast });
     } catch (err) {
-      console.log(`  ${icons.error} ${dim("Parse failed:")} ${basename(file)}`);
-      console.log(`    ${dim(err.message)}`);
+      p2.log.error(`Parse failed: ${pc3.dim(basename(file))}
+${pc3.red(err.message)}`);
       parseErrors++;
     }
   }
@@ -340,20 +487,18 @@ async function buildCommand(options) {
     projectContext,
     debug: options.debug
   });
-  const connectSpinner = spinner(`Connecting to ${providerName}...`).start();
+  const sConnect = p2.spinner();
+  sConnect.start(`Connecting to ${providerName}...`);
   try {
     const connected = await generator.testConnection();
     if (!connected) {
-      if (config.provider === "ollama") {
-        connectSpinner.fail(error("Failed to connect to Ollama. Is it running?"));
-      } else {
-        connectSpinner.fail(error("Failed to connect to Gemini API"));
-      }
+      const msg = config.provider === "ollama" ? "Failed to connect to Ollama. Is it running?" : "Failed to connect to Gemini API";
+      sConnect.stop(msg, 1);
       process.exit(1);
     }
-    connectSpinner.succeed(dim(`Connected to ${providerName}`));
+    sConnect.stop(`Connected to ${pc3.cyan(providerName)}`);
   } catch (error2) {
-    connectSpinner.fail(error(`Connection failed: ${error2.message}`));
+    sConnect.stop(`Connection failed: ${error2.message}`, 1);
     process.exit(1);
   }
   const provider = generator.getProvider();
@@ -362,31 +507,29 @@ async function buildCommand(options) {
     if (typeof ollama.checkModelExists === "function") {
       const exists = await ollama.checkModelExists();
       if (!exists) {
-        const modelName = config.ollama?.model || "llama3";
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        console.log();
-        const answer = await new Promise((resolve4) => {
-          rl.question(`  ${icons.info} Model '${accent(modelName)}' is not found locally.
-  ${dim("Do you want to pull it now? [Y/n]")} `, resolve4);
+        const modelName2 = config.ollama?.model || "llama3";
+        const shouldPull = await p2.confirm({
+          message: `Model ${pc3.cyan(modelName2)} not found locally. Pull it now?`,
+          initialValue: true
         });
-        rl.close();
-        if (answer.toLowerCase() === "n") {
-          printError("Model missing, cannot proceed.");
+        if (p2.isCancel(shouldPull) || !shouldPull) {
+          p2.cancel("Operation cancelled. Model missing.");
           process.exit(1);
         }
-        const pullSpinner = spinner(`Pulling ${modelName}...`).start();
+        const sPull = p2.spinner();
+        sPull.start(`Pulling ${modelName2}...`);
         try {
           await ollama.pullModel((status, completed, total) => {
             if (completed && total) {
               const percent = Math.round(completed / total * 100);
-              pullSpinner.text = `Pulling ${modelName}: ${status} ${percent}%`;
+              sPull.message(`Pulling ${modelName2}: ${status} ${percent}%`);
             } else {
-              pullSpinner.text = `Pulling ${modelName}: ${status}`;
+              sPull.message(`Pulling ${modelName2}: ${status}`);
             }
           });
-          pullSpinner.succeed(`${modelName} ready`);
+          sPull.stop(`${pc3.green(modelName2)} is ready`);
         } catch (e) {
-          pullSpinner.fail(`Failed to pull model: ${e.message}`);
+          sPull.stop(`Failed to pull model: ${e.message}`, 1);
           process.exit(1);
         }
       }
@@ -397,12 +540,15 @@ async function buildCommand(options) {
   let successCount = 0;
   let failCount = parseErrors;
   let cachedCount = 0;
+  const generatedFiles = [];
   if (!existsSync3(outDir)) {
     mkdirSync2(outDir, { recursive: true });
   }
   copyResources(sourceDir, outDir);
-  newline();
-  console.log(heading("Compiling"));
+  if (!isWatch) {
+    console.log(pc3.bold(`
+\uD83D\uDE80 Compiling`));
+  }
   for (const file of files) {
     if (!fileData.has(file))
       continue;
@@ -412,17 +558,15 @@ async function buildCommand(options) {
     if (!existsSync3(outDirForFile)) {
       mkdirSync2(outDirForFile, { recursive: true });
     }
-    const fileSpinner = spinner(`${relativePath}`).start();
+    const sFile = p2.spinner();
+    sFile.start(`${pc3.dim(relativePath)}`);
     const fileStart = Date.now();
     try {
       const { hash, ast } = fileData.get(file);
       const cached = await cas.get(hash);
       let finalCode;
       if (!options.force && cached) {
-        fileSpinner.stopAndPersist({
-          symbol: icons.cached,
-          text: `${dim(relativePath)} ${dim("(cached)")}`
-        });
+        sFile.stop(`${pc3.dim(relativePath)} ${pc3.blue("(cached)")}`);
         finalCode = cached.code;
         cachedCount++;
       } else {
@@ -430,25 +574,49 @@ async function buildCommand(options) {
         finalCode = generated.code;
         await cas.put(hash, finalCode);
         const fileDuration = Date.now() - fileStart;
-        fileSpinner.succeed(`${relativePath} ${dim(`${fileDuration}ms`)}`);
+        sFile.stop(`${relativePath} ${pc3.dim(`${fileDuration}ms`)}`);
       }
       writeFileSync3(outFile, finalCode, "utf-8");
+      generatedFiles.push(outFile);
       successCount++;
     } catch (error2) {
-      fileSpinner.fail(`${relativePath} ${dim(error2.message)}`);
+      sFile.stop(`${pc3.red(relativePath)} ${pc3.dim(error2.message)}`, 1);
       failCount++;
     }
   }
   const totalDuration = Date.now() - startTime;
-  newline();
-  console.log(heading("Summary"));
-  console.log(`  ${icons.success} ${num(successCount)} compiled ${cachedCount > 0 ? dim(`(${cachedCount} cached)`) : ""}`);
-  if (failCount > 0) {
-    console.log(`  ${icons.error} ${num(failCount)} failed`);
+  if (!isWatch) {
+    p2.note(`${pc3.green(icons.success)} ${pc3.bold(successCount)} compiled ${cachedCount > 0 ? pc3.dim(`(${cachedCount} cached)`) : ""}
+` + (failCount > 0 ? `${pc3.red(icons.error)} ${pc3.bold(failCount)} failed
+` : "") + `${pc3.white(icons.arrow)} ${pc3.white(duration(totalDuration))}`, "Summary");
+    const entryFiles = files.filter((f) => {
+      const ast = fileData.get(f)?.ast;
+      return ast?.intents.some((i) => i.entryPoint);
+    }).map((f) => {
+      const rel = f.substring(sourceDir.length + 1).replace(/\.intent$/, ".ts");
+      return join3(config.outDir, rel);
+    });
+    let runCmd = "npx tsx";
+    try {
+      execSync("bun --version", { stdio: "ignore" });
+      runCmd = "bun run";
+    } catch (e) {
+      runCmd = "npx tsx";
+    }
+    if (entryFiles.length > 0) {
+      p2.note(entryFiles.map((f) => `${pc3.white("$")} ${pc3.cyan(pc3.bold(`${runCmd} ${f}`))}`).join(`
+`), "Next Steps: Run your code");
+    } else if (successCount > 0) {
+      const firstFilePath = files.find((f) => fileData.has(f));
+      const relPath = firstFilePath ? firstFilePath.substring(sourceDir.length + 1).replace(/\.intent$/, ".ts") : "";
+      const outPath = join3(config.outDir, relPath);
+      p2.note(`${pc3.white("$")} ${pc3.cyan(pc3.bold(`${runCmd} ${outPath}`))}
+
+` + `${pc3.white("Tip: Add ")}${pc3.yellow("entry")}${pc3.white(" to an intent to make it the main entry point.")}`, "Next Steps: Run your code");
+    }
+    p2.outro("Build finished! ✨");
   }
-  console.log(`  ${icons.arrow} ${duration(totalDuration)}`);
-  newline();
-  if (failCount > 0) {
+  if (failCount > 0 && !isWatch) {
     process.exit(1);
   }
 }
@@ -463,7 +631,7 @@ async function watchCommand(options) {
   console.log(label("Watching", path(sourceDir)));
   newline();
   await buildCommand(options).catch(() => {});
-  const watchSpinner = spinner("Waiting for changes...").start();
+  const watchSpinner = spinner2("Waiting for changes...").start();
   let isBuilding = false;
   let debounceTimer = null;
   watch(sourceDir, { recursive: true }, (eventType, filename) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intend-it/cli",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "CLI for the Intend programming language",
   "type": "module",
   "bin": {
@@ -12,7 +12,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target node --external picocolors --external ora --external @intend-it/parser --external @intend-it/core",
+    "build": "bun build ./src/index.ts --outdir ./dist --target node --external picocolors --external ora --external @clack/prompts --external @intend-it/parser --external @intend-it/core",
     "clean": "rm -rf dist",
     "dev": "bun run src/index.ts"
   },
@@ -29,10 +29,11 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@intend-it/parser": "^1.3.0",
-    "@intend-it/core": "^4.0.0",
-    "picocolors": "^1.1.1",
-    "ora": "^8.1.1"
+    "@clack/prompts": "^0.11.0",
+    "@intend-it/core": "^4.0.1",
+    "@intend-it/parser": "^1.3.1",
+    "ora": "^8.1.1",
+    "picocolors": "^1.1.1"
   },
   "devDependencies": {
     "@types/bun": "latest",