agdi 1.0.0

package/README.md

@@ -0,0 +1,100 @@
+# agdi 🚀
+
+**The AI-powered app generator** - Build full-stack applications from natural language in your terminal.
+
+[![npm version](https://img.shields.io/npm/v/agdi.svg)](https://www.npmjs.com/package/agdi)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Installation
+
+```bash
+npm install -g agdi
+```
+
+Or run directly with npx:
+```bash
+npx agdi init
+```
+
+## Quick Start
+
+```bash
+# Interactive mode (recommended)
+agdi init
+
+# Generate from prompt
+agdi generate "Create a todo app with dark mode"
+
+# Configure API keys
+agdi auth
+```
+
+## Features
+
+- 🆓 **FREE AI Access** - No API key required (powered by Puter.com)
+- 🤖 **400+ AI Models** - GPT-5, Claude 4.5, Gemini 3, Llama 4, and more
+- ⚡ **Instant Generation** - Full React/Vite apps in seconds
+- 💬 **Interactive Mode** - Chat-based coding assistant
+- 🔑 **Bring Your Own Key** - Use your own OpenAI, Anthropic, or Gemini keys
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `agdi init` | Interactive project creation wizard |
+| `agdi generate <prompt>` | Generate app from prompt |
+| `agdi chat` | Start interactive coding session |
+| `agdi auth` | Configure API keys |
+| `agdi models` | List available AI models |
+| `agdi --help` | Show all commands |
+
+## Examples
+
+```bash
+# Create a dashboard
+agdi generate "Build an analytics dashboard with charts"
+
+# Create an e-commerce store
+agdi generate "Create a product catalog with shopping cart" -m claude-sonnet-4-5
+
+# Use specific model
+agdi generate "Build a blog" -p puter -m gpt-5
+```
+
+## Supported Models
+
+### Free (No API Key)
+- GPT-5, GPT-5 Mini
+- Claude 4.5 Sonnet, Claude 4.5 Opus
+- Gemini 3 Pro, Gemini 2.5 Flash
+- Llama 4, DeepSeek R1, Grok 3
+
+### Bring Your Own Key
+- OpenAI (GPT-5, o3-mini)
+- Anthropic (Claude 4.5)
+- Google (Gemini 3)
+- DeepSeek, Mistral, and more
+
+## Configuration
+
+API keys are stored in `~/.agdi/config.json`:
+
+```bash
+agdi auth                    # Interactive setup
+agdi auth --status           # Show current config
+```
+
+## Requirements
+
+- Node.js 18 or higher
+- npm or yarn
+
+## Links
+
+- 🌐 [Website](https://agdi.dev)
+- 📖 [Documentation](https://docs.agdi.dev)
+- 🐙 [GitHub](https://github.com/agdi-dev/agdi)
+
+## License
+
+MIT © [Agdi Systems Inc.](https://agdi.dev)

package/bin/agdi.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';

package/dist/index.js

@@ -0,0 +1,665 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk3 from "chalk";
+import ora2 from "ora";
+import { input as input3, select as select2, confirm as confirm2 } from "@inquirer/prompts";
+
+// src/core/llm/index.ts
+var PuterProvider = class {
+  model;
+  constructor(config) {
+    this.model = config.model || "gpt-4.1-nano";
+  }
+  async generate(prompt, systemPrompt) {
+    const response = await fetch("https://api.puter.com/ai/chat", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        model: this.model,
+        messages: [
+          ...systemPrompt ? [{ role: "system", content: systemPrompt }] : [],
+          { role: "user", content: prompt }
+        ]
+      })
+    });
+    if (!response.ok) {
+      throw new Error(`Puter API error: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    let text = "";
+    if (typeof data === "string") {
+      text = data;
+    } else if (data.message?.content) {
+      if (Array.isArray(data.message.content)) {
+        text = data.message.content.map((c) => c.text || "").join("");
+      } else {
+        text = data.message.content;
+      }
+    } else if (data.choices?.[0]?.message?.content) {
+      text = data.choices[0].message.content;
+    }
+    return {
+      text,
+      usage: typeof data !== "string" ? data.usage : void 0
+    };
+  }
+};
+var GeminiProvider = class {
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  async generate(prompt, systemPrompt) {
+    const { GoogleGenAI } = await import("@google/genai");
+    const ai = new GoogleGenAI({ apiKey: this.config.apiKey });
+    const contents = [];
+    if (systemPrompt) {
+      contents.push({ role: "user", parts: [{ text: systemPrompt }] });
+      contents.push({ role: "model", parts: [{ text: "Understood. I will follow these instructions." }] });
+    }
+    contents.push({ role: "user", parts: [{ text: prompt }] });
+    const response = await ai.models.generateContent({
+      model: this.config.model || "gemini-2.5-flash",
+      contents
+    });
+    const text = response.candidates?.[0]?.content?.parts?.[0]?.text || "";
+    return {
+      text,
+      usage: void 0
+    };
+  }
+};
+var PUTER_MODELS = {
+  // OpenAI Models
+  "gpt-5": "GPT-5 (Aug 2025)",
+  "gpt-5-mini": "GPT-5 Mini",
+  "gpt-4o": "GPT-4o",
+  "o3-mini": "o3 Mini (Jan 2025)",
+  "o1": "o1 (Reasoning)",
+  // Claude Models
+  "claude-opus-4-5": "Claude 4.5 Opus (Nov 2025)",
+  "claude-sonnet-4-5": "Claude 4.5 Sonnet (Sep 2025)",
+  "claude-sonnet-4": "Claude Sonnet 4",
+  "claude-3-5-sonnet": "Claude 3.5 Sonnet",
+  // Google Models  
+  "gemini-3-pro-preview": "Gemini 3 Pro (Preview)",
+  "google/gemini-2.5-flash": "Gemini 2.5 Flash",
+  "google/gemini-2.5-pro": "Gemini 2.5 Pro",
+  // Meta Llama
+  "meta/llama-4-maverick": "Llama 4 Maverick (Apr 2025)",
+  "meta/llama-4-scout": "Llama 4 Scout",
+  "meta/llama-3.3-70b": "Llama 3.3 70B",
+  // DeepSeek
+  "deepseek/deepseek-v3.2": "DeepSeek V3.2 (Dec 2025)",
+  "deepseek/deepseek-reasoner": "DeepSeek R1",
+  // xAI
+  "x-ai/grok-3": "Grok 3",
+  // Mistral
+  "mistral/mistral-large": "Mistral Large"
+};
+function createLLMProvider(provider, config) {
+  switch (provider) {
+    case "puter":
+      return new PuterProvider(config);
+    case "gemini":
+      return new GeminiProvider(config);
+    default:
+      throw new Error(`Unsupported LLM provider: ${provider}`);
+  }
+}
+
+// src/core/project/index.ts
+var ProjectManager = class {
+  project = null;
+  /**
+   * Create a new project
+   */
+  create(name, prompt) {
+    this.project = {
+      id: crypto.randomUUID(),
+      name,
+      description: "",
+      prompt,
+      files: [],
+      dependencies: [],
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+    return this.project;
+  }
+  /**
+   * Get current project
+   */
+  get() {
+    return this.project;
+  }
+  /**
+   * Load an existing project
+   */
+  load(project) {
+    this.project = project;
+  }
+  /**
+   * Update project files
+   */
+  updateFiles(files) {
+    if (this.project) {
+      this.project.files = files;
+      this.project.updatedAt = /* @__PURE__ */ new Date();
+    }
+  }
+  /**
+   * Update project dependencies
+   */
+  updateDependencies(dependencies) {
+    if (this.project) {
+      this.project.dependencies = dependencies;
+      this.project.updatedAt = /* @__PURE__ */ new Date();
+    }
+  }
+  /**
+   * Add a file to the project
+   */
+  addFile(file) {
+    if (this.project) {
+      const existingIndex = this.project.files.findIndex((f) => f.path === file.path);
+      if (existingIndex >= 0) {
+        this.project.files[existingIndex] = file;
+      } else {
+        this.project.files.push(file);
+      }
+      this.project.updatedAt = /* @__PURE__ */ new Date();
+    }
+  }
+  /**
+   * Clear current project
+   */
+  clear() {
+    this.project = null;
+  }
+  /**
+   * Check if project exists
+   */
+  hasProject() {
+    return this.project !== null;
+  }
+};
+
+// src/core/io/index.ts
+import JSZip from "jszip";
+
+// src/core/architect/index.ts
+var SYSTEM_PROMPT = `You are Agdi Architect, an expert software architect AI.
+Your job is to generate complete, production-ready React applications.
+Always use TypeScript, Tailwind CSS, and Vite.
+Generate all necessary files including package.json, tsconfig.json, vite.config.ts.
+Make the UI beautiful with modern design patterns.`;
+async function generatePlan(prompt, llm) {
+  const planPrompt = `Create a detailed plan for: ${prompt}
+
+Return a JSON object with:
+{
+  "name": "app-name",
+  "description": "Brief description",
+  "files": [{"path": "src/App.tsx", "description": "Main component"}],
+  "dependencies": ["react", "tailwindcss"],
+  "architecture": "Component architecture description"
+}
+
+Return ONLY valid JSON, no markdown.`;
+  const response = await llm.generate(planPrompt, SYSTEM_PROMPT);
+  try {
+    const jsonMatch = response.text.match(/\{[\s\S]*\}/);
+    if (jsonMatch) {
+      return JSON.parse(jsonMatch[0]);
+    }
+  } catch (e) {
+  }
+  return {
+    name: "my-app",
+    description: prompt,
+    files: [
+      { path: "src/App.tsx", description: "Main App component" },
+      { path: "src/main.tsx", description: "Entry point" },
+      { path: "src/index.css", description: "Global styles" }
+    ],
+    dependencies: ["react", "react-dom", "tailwindcss"],
+    architecture: "Simple React SPA"
+  };
+}
+async function generateFile(filePath, fileDescription, plan, llm) {
+  const prompt = `Generate the complete code for: ${filePath}
+
+Context:
+- App: ${plan.name}
+- Description: ${plan.description}
+- This file: ${fileDescription}
+- Architecture: ${plan.architecture}
+
+Return ONLY the file content, no markdown code blocks.`;
+  const response = await llm.generate(prompt, SYSTEM_PROMPT);
+  let content = response.text;
+  if (content.startsWith("```")) {
+    content = content.replace(/^```[\w]*\n/, "").replace(/\n```$/, "");
+  }
+  return {
+    path: filePath,
+    content: content.trim()
+  };
+}
+async function generateApp(prompt, llm, onProgress) {
+  onProgress?.("Planning app architecture...");
+  const plan = await generatePlan(prompt, llm);
+  onProgress?.("Generating files...");
+  const files = [];
+  for (const fileSpec of plan.files) {
+    onProgress?.(`Creating ${fileSpec.path}...`, fileSpec.path);
+    const file = await generateFile(fileSpec.path, fileSpec.description, plan, llm);
+    files.push(file);
+  }
+  onProgress?.("Creating package.json...", "package.json");
+  files.push({
+    path: "package.json",
+    content: JSON.stringify({
+      name: plan.name,
+      version: "0.1.0",
+      type: "module",
+      scripts: {
+        dev: "vite",
+        build: "vite build",
+        preview: "vite preview"
+      },
+      dependencies: plan.dependencies.reduce((acc, dep) => {
+        acc[dep] = "latest";
+        return acc;
+      }, {})
+    }, null, 2)
+  });
+  return { plan, files };
+}
+
+// src/utils/fs.ts
+import fs from "fs-extra";
+import path from "path";
+async function writeProject(project, outputDir) {
+  await fs.ensureDir(outputDir);
+  for (const file of project.files) {
+    const filePath = path.join(outputDir, file.path);
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.writeFile(filePath, file.content, "utf-8");
+  }
+}
+
+// src/utils/config.ts
+import fs2 from "fs-extra";
+import path2 from "path";
+import os from "os";
+var CONFIG_DIR = path2.join(os.homedir(), ".agdi");
+var CONFIG_FILE = path2.join(CONFIG_DIR, "config.json");
+function loadConfig() {
+  try {
+    if (fs2.existsSync(CONFIG_FILE)) {
+      return fs2.readJsonSync(CONFIG_FILE);
+    }
+  } catch {
+  }
+  return {};
+}
+function saveConfig(config) {
+  try {
+    fs2.ensureDirSync(CONFIG_DIR);
+    fs2.writeJsonSync(CONFIG_FILE, config, { spaces: 2 });
+  } catch (error) {
+    console.error("Failed to save config:", error);
+  }
+}
+
+// src/commands/auth.ts
+import { input, select, password } from "@inquirer/prompts";
+import chalk from "chalk";
+async function login() {
+  console.log(chalk.cyan.bold("\n\u{1F510} Agdi Authentication\n"));
+  const config = loadConfig();
+  const provider = await select({
+    message: "How would you like to authenticate?",
+    choices: [
+      { name: "\u{1F193} Agdi Cloud (FREE) - No API key needed!", value: "puter" },
+      { name: "\u{1F511} Bring Your Own Key", value: "byok" },
+      { name: "\u{1F3E0} Local LLM (Ollama)", value: "ollama" }
+    ]
+  });
+  if (provider === "puter") {
+    config.defaultProvider = "puter";
+    saveConfig(config);
+    console.log(chalk.green("\n\u2705 Using FREE Agdi Cloud (Puter.com)"));
+    console.log(chalk.gray("No API key needed - access to 400+ models!\n"));
+    return;
+  }
+  if (provider === "ollama") {
+    const ollamaUrl = await input({
+      message: "Ollama server URL:",
+      default: "http://localhost:11434"
+    });
+    config.ollamaUrl = ollamaUrl;
+    config.defaultProvider = "ollama";
+    saveConfig(config);
+    console.log(chalk.green("\n\u2705 Ollama configured"));
+    console.log(chalk.gray(`Server: ${ollamaUrl}
+`));
+    return;
+  }
+  console.log(chalk.cyan("\n\u{1F511} Configure API Keys\n"));
+  const keyType = await select({
+    message: "Which provider?",
+    choices: [
+      { name: "Google Gemini", value: "gemini" },
+      { name: "OpenAI (GPT-4)", value: "openai" },
+      { name: "Anthropic (Claude)", value: "anthropic" },
+      { name: "DeepSeek", value: "deepseek" },
+      { name: "OpenRouter (Multi-model)", value: "openrouter" }
+    ]
+  });
+  const apiKey = await password({
+    message: `Enter your ${keyType} API key:`,
+    mask: "*"
+  });
+  switch (keyType) {
+    case "gemini":
+      config.geminiApiKey = apiKey;
+      break;
+    case "openai":
+      config.openaiApiKey = apiKey;
+      break;
+    case "anthropic":
+      config.anthropicApiKey = apiKey;
+      break;
+    case "deepseek":
+      config.deepseekApiKey = apiKey;
+      break;
+    case "openrouter":
+      config.openrouterApiKey = apiKey;
+      break;
+  }
+  config.defaultProvider = keyType;
+  saveConfig(config);
+  console.log(chalk.green(`
+\u2705 ${keyType} API key saved securely`));
+  console.log(chalk.gray("Keys stored in ~/.agdi/config.json\n"));
+}
+async function showStatus() {
+  const config = loadConfig();
+  console.log(chalk.cyan.bold("\n\u{1F4CA} Authentication Status\n"));
+  const providers = [
+    { name: "Gemini", key: config.geminiApiKey },
+    { name: "OpenAI", key: config.openaiApiKey },
+    { name: "Anthropic", key: config.anthropicApiKey },
+    { name: "DeepSeek", key: config.deepseekApiKey },
+    { name: "OpenRouter", key: config.openrouterApiKey }
+  ];
+  for (const p of providers) {
+    const status = p.key ? chalk.green("\u2713 Configured") : chalk.gray("\u2717 Not set");
+    console.log(`  ${p.name.padEnd(12)} ${status}`);
+  }
+  console.log(chalk.cyan(`
+  Default: ${config.defaultProvider || "puter (FREE)"}
+`));
+  console.log(chalk.gray('\u{1F4A1} Tip: Use "agdi auth" to reconfigure\n'));
+}
+
+// src/commands/chat.ts
+import { input as input2 } from "@inquirer/prompts";
+import chalk2 from "chalk";
+import ora from "ora";
+var SYSTEM_PROMPT2 = `You are Agdi, an expert AI software architect.
+You help users build applications by generating code.
+When asked to create something, output complete, working code files.
+Be concise but thorough. Use TypeScript and modern best practices.`;
+async function startChat() {
+  console.log(chalk2.cyan.bold("\n\u{1F4AC} Agdi Interactive Mode\n"));
+  console.log(chalk2.gray('Type your coding requests. Type "exit" to quit.\n'));
+  const config = loadConfig();
+  const provider = config.defaultProvider || "puter";
+  let apiKey = "";
+  switch (provider) {
+    case "gemini":
+      apiKey = config.geminiApiKey || "";
+      break;
+    case "puter":
+      apiKey = "";
+      break;
+    default:
+      apiKey = config.geminiApiKey || "";
+  }
+  if (provider !== "puter" && !apiKey) {
+    console.log(chalk2.yellow("\u26A0\uFE0F  No API key configured for " + provider));
+    console.log(chalk2.gray('Run "agdi auth" to configure, or use FREE mode.\n'));
+    return;
+  }
+  console.log(chalk2.gray(`Using provider: ${chalk2.cyan(provider)}`));
+  console.log(chalk2.gray("\u2500".repeat(50) + "\n"));
+  const pm = new ProjectManager();
+  while (true) {
+    const userInput = await input2({
+      message: chalk2.cyan("You:")
+    });
+    if (userInput.toLowerCase() === "exit" || userInput.toLowerCase() === "quit") {
+      console.log(chalk2.gray("\n\u{1F44B} Goodbye!\n"));
+      break;
+    }
+    if (!userInput.trim()) {
+      continue;
+    }
+    const spinner = ora("Thinking...").start();
+    try {
+      const llm = createLLMProvider(provider, { apiKey, model: config.defaultModel });
+      if (userInput.toLowerCase().includes("create") || userInput.toLowerCase().includes("build") || userInput.toLowerCase().includes("make")) {
+        spinner.text = "Generating application...";
+        pm.create("my-app", userInput);
+        const { plan, files } = await generateApp(userInput, llm, (step) => {
+          spinner.text = step;
+        });
+        pm.updateFiles(files);
+        spinner.succeed("Application generated!");
+        console.log(chalk2.green("\n\u{1F4C1} Files created:"));
+        for (const file of files) {
+          console.log(chalk2.gray(`   - ${file.path}`));
+        }
+        const shouldWrite = await input2({
+          message: "Write files to disk? (y/n):",
+          default: "y"
+        });
+        if (shouldWrite.toLowerCase() === "y") {
+          const dir = await input2({
+            message: "Output directory:",
+            default: "./generated-app"
+          });
+          await writeProject(pm.get(), dir);
+          console.log(chalk2.green(`
+\u2705 Files written to ${dir}
+`));
+        }
+      } else {
+        const response = await llm.generate(userInput, SYSTEM_PROMPT2);
+        spinner.stop();
+        console.log(chalk2.cyan("\nAgdi: ") + response.text + "\n");
+      }
+    } catch (error) {
+      spinner.fail("Error");
+      console.error(chalk2.red(error instanceof Error ? error.message : String(error)));
+      console.log("");
+    }
+  }
+}
+
+// src/index.ts
+var BANNER = `
+${chalk3.cyan(`    ___              __ _  `)}
+${chalk3.cyan(`   /   |  ____ _____/ /(_) `)}
+${chalk3.cyan(`  / /| | / __ \`/ __  // /  `)}
+${chalk3.cyan(` / ___ |/ /_/ / /_/ // /   `)}
+${chalk3.cyan(`/_/  |_|\\__, /\\__,_//_/    `)}
+${chalk3.cyan(`       /____/              `)}
+`;
+var program = new Command();
+console.log(BANNER);
+console.log(chalk3.gray("  The Open Source AI Architect"));
+console.log(chalk3.gray("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+program.name("agdi").description(chalk3.cyan("\u{1F680} AI-powered app generator - build apps from natural language")).version("1.0.0");
+program.command("auth").description("Login or configure API keys").option("--status", "Show authentication status").action(async (options) => {
+  if (options.status) {
+    await showStatus();
+  } else {
+    await login();
+  }
+});
+program.command("chat").description("Start an interactive coding session").action(startChat);
+program.command("init").description("Create a new project interactively").action(async () => {
+  const config = loadConfig();
+  const provider = await select2({
+    message: "Select AI provider:",
+    choices: [
+      { name: "\u{1F193} Agdi Cloud (FREE - No API key!)", value: "puter" },
+      { name: "\u{1F511} Gemini (Requires API key)", value: "gemini" }
+    ]
+  });
+  if (provider === "gemini" && !config.geminiApiKey) {
+    console.log(chalk3.yellow("\n\u26A0\uFE0F  No Gemini API key configured\n"));
+    const apiKey = await input3({
+      message: "Enter your Gemini API key:",
+      validate: (v) => v.trim().length > 0 || "API key is required"
+    });
+    config.geminiApiKey = apiKey.trim();
+    saveConfig(config);
+    console.log(chalk3.green("\u2705 API key saved\n"));
+  }
+  const prompt = await input3({
+    message: "What would you like to build?",
+    default: "A modern todo app with categories, dark mode, and local storage"
+  });
+  let model;
+  if (provider === "puter") {
+    model = await select2({
+      message: "Select AI model (400+ available):",
+      choices: [
+        { name: "\u26A1 GPT-4.1 Nano (Fast)", value: "gpt-4.1-nano" },
+        { name: "\u{1F680} Claude Sonnet 4 (Best)", value: "claude-sonnet-4" },
+        { name: "\u{1F9E0} Claude 3.5 Sonnet", value: "claude-3-5-sonnet" },
+        { name: "\u{1F48E} GPT-4o", value: "gpt-4o" },
+        { name: "\u{1F525} Gemini 2.5 Flash", value: "google/gemini-2.5-flash" },
+        { name: "\u{1F999} Llama 3.3 70B", value: "meta/llama-3.3-70b" },
+        { name: "\u{1F30A} DeepSeek R1", value: "deepseek/deepseek-r1" },
+        { name: "\u{1F916} Mistral Large", value: "mistral/mistral-large" },
+        { name: "\u{1F47D} Grok 2", value: "x-ai/grok-2" }
+      ]
+    });
+  } else {
+    model = await select2({
+      message: "Select AI model:",
+      choices: [
+        { name: "Gemini 2.5 Flash (Fast)", value: "gemini-2.5-flash" },
+        { name: "Gemini 2.5 Pro (Best quality)", value: "gemini-2.5-pro" }
+      ]
+    });
+  }
+  const defaultDir = `./${prompt.split(" ").slice(0, 3).join("-").toLowerCase().replace(/[^a-z0-9-]/g, "")}`;
+  const outputDir = await input3({
+    message: "Output directory:",
+    default: defaultDir
+  });
+  const shouldProceed = await confirm2({
+    message: `Generate app in ${chalk3.cyan(outputDir)} using ${chalk3.yellow(model)}?`,
+    default: true
+  });
+  if (!shouldProceed) {
+    console.log(chalk3.yellow("\nCancelled."));
+    return;
+  }
+  console.log("");
+  const spinner = ora2("Initializing AI architect...").start();
+  try {
+    const llm = createLLMProvider(provider, {
+      apiKey: provider === "gemini" ? config.geminiApiKey : "",
+      model
+    });
+    const pm = new ProjectManager();
+    pm.create(outputDir.replace("./", ""), prompt);
+    const { plan, files } = await generateApp(prompt, llm, (step, file) => {
+      spinner.text = file ? `${step} ${chalk3.gray(file)}` : step;
+    });
+    pm.updateFiles(files);
+    pm.updateDependencies(plan.dependencies);
+    spinner.text = "Writing files to disk...";
+    await writeProject(pm.get(), outputDir);
+    spinner.succeed(chalk3.green("App generated successfully!"));
+    console.log(chalk3.gray("\n\u{1F4C1} Project created at:"), chalk3.cyan(outputDir));
+    console.log(chalk3.gray(`\u{1F4C4} ${files.length} files generated
+`));
+    console.log(chalk3.white("Next steps:\n"));
+    console.log(chalk3.gray(`  cd ${outputDir}`));
+    console.log(chalk3.gray("  npm install"));
+    console.log(chalk3.gray("  npm run dev\n"));
+  } catch (error) {
+    spinner.fail(chalk3.red("Generation failed"));
+    console.error(chalk3.red("\n" + (error instanceof Error ? error.message : String(error))));
+    process.exit(1);
+  }
+});
+program.command("generate <prompt>").alias("g").description("Generate an app from a prompt").option("-p, --provider <provider>", "AI provider (puter or gemini)", "puter").option("-m, --model <model>", "AI model to use", "claude-sonnet-4").option("-o, --output <dir>", "Output directory", "./generated-app").action(async (prompt, options) => {
+  const config = loadConfig();
+  const provider = options.provider;
+  if (provider === "gemini" && !config.geminiApiKey) {
+    console.error(chalk3.red("\u274C No Gemini API key configured. Run: agdi auth"));
+    console.error(chalk3.yellow("\u{1F4A1} Tip: Use --provider puter for FREE access without API keys!"));
+    process.exit(1);
+  }
+  const spinner = ora2(`Generating app with ${chalk3.cyan(options.model)}...`).start();
+  try {
+    const llm = createLLMProvider(provider, {
+      apiKey: provider === "gemini" ? config.geminiApiKey : "",
+      model: options.model
+    });
+    const pm = new ProjectManager();
+    pm.create(options.output.replace("./", ""), prompt);
+    const { plan, files } = await generateApp(prompt, llm, (step) => {
+      spinner.text = step;
+    });
+    pm.updateFiles(files);
+    pm.updateDependencies(plan.dependencies);
+    await writeProject(pm.get(), options.output);
+    spinner.succeed(`App generated in ${chalk3.cyan(options.output)}`);
+  } catch (error) {
+    spinner.fail("Generation failed");
+    console.error(chalk3.red(error instanceof Error ? error.message : String(error)));
+    process.exit(1);
+  }
+});
+program.command("config").description("Show or modify configuration").option("--show", "Show current configuration").action(async (options) => {
+  await showStatus();
+});
+program.command("models").description("List available AI models").action(() => {
+  console.log(chalk3.cyan.bold("\n\u{1F916} Available Puter.com Models (FREE - No API key!)\n"));
+  const categories = {
+    "OpenAI": ["gpt-4.1-nano", "gpt-4.1-mini", "gpt-4o", "gpt-4-turbo", "o1", "o1-mini"],
+    "Anthropic": ["claude-sonnet-4", "claude-3-5-sonnet", "claude-3-opus"],
+    "Google": ["google/gemini-2.5-flash", "google/gemini-2.5-pro"],
+    "Open Source": ["meta/llama-3.3-70b", "mistral/mistral-large", "deepseek/deepseek-r1", "x-ai/grok-2"]
+  };
+  for (const [category, models] of Object.entries(categories)) {
+    console.log(chalk3.yellow(`
+  ${category}:`));
+    for (const model of models) {
+      const name = PUTER_MODELS[model] || model;
+      console.log(chalk3.gray(`    - ${model}`) + chalk3.white(` (${name})`));
+    }
+  }
+  console.log(chalk3.gray("\n  ... and 400+ more models available!\n"));
+  console.log(chalk3.white('Usage: agdi generate "prompt" -p puter -m claude-sonnet-4\n'));
+});
+program.action(() => {
+  program.help();
+});
+program.parse();

package/package.json

@@ -0,0 +1,63 @@
+{
+    "name": "agdi",
+    "version": "1.0.0",
+    "description": "AI-powered app generator - build full-stack apps from natural language in your terminal",
+    "type": "module",
+    "bin": {
+        "agdi": "./bin/agdi.js"
+    },
+    "main": "./dist/index.js",
+    "files": [
+        "bin",
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsup src/index.ts --format esm --clean",
+        "dev": "tsx src/index.ts",
+        "start": "node bin/agdi.js",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "cli",
+        "ai",
+        "code-generation",
+        "app-generator",
+        "llm",
+        "gpt",
+        "claude",
+        "gemini",
+        "react",
+        "vite",
+        "full-stack"
+    ],
+    "author": "Agdi Systems Inc.",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/agdi-dev/agdi"
+    },
+    "homepage": "https://agdi.dev",
+    "bugs": {
+        "url": "https://github.com/agdi-dev/agdi/issues"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "tsx": "^4.7.0",
+        "typescript": "^5.4.0",
+        "@types/fs-extra": "^11.0.0",
+        "@types/node": "^20.0.0"
+    },
+    "dependencies": {
+        "@google/genai": "^1.0.0",
+        "@inquirer/prompts": "^5.0.0",
+        "chalk": "^5.3.0",
+        "commander": "^12.0.0",
+        "fs-extra": "^11.2.0",
+        "jszip": "^3.10.0",
+        "ora": "^8.0.0"
+    }
+}