npm - agdi - Versions diffs - 2.8.8 → 2.9.0 - Mend

agdi 2.8.8 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/README.md CHANGED Viewed

@@ -18,311 +18,332 @@
 [![License](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
 [![Node](https://img.shields.io/badge/Node.js-18+-339933?style=for-the-badge&logo=node.js)](https://nodejs.org/)
-**Build apps from natural language • Multi-Agent AI • Cinematic Dark Mode**
+**Build apps from natural language • Latest 2026 AI Models • Clean Terminal UI**
-[Website](https://agdi-dev.vercel.app) · [npm](https://www.npmjs.com/package/agdi) · [GitHub](https://github.com/anassagd432/Agdi-dev)
+[Website](https://agdi-dev.vercel.app) · [npm](https://www.npmjs.com/package/agdi) ·  [GitHub](https://github.com/anassagd432/Agdi-dev)
 </div>
 ---
-## 🚀 What's New in v2.7.0
+## 🚀 Quick Start
-<div align="center">
-  <img src="https://img.shields.io/badge/NEW-GitHub_Import-00d1b2?style=for-the-badge" alt="GitHub Import">
-  <img src="https://img.shields.io/badge/NEW-Voice_Commands-ff6b6b?style=for-the-badge" alt="Voice">
-  <img src="https://img.shields.io/badge/NEW-Self_Repair-8b5cf6?style=for-the-badge" alt="Self-Repair">
-</div>
+### Installation
-### ✨ New Features
+```bash
+npm install -g agdi
+```
-| Feature | Description |
-|---------|-------------|
-| 🐙 **GitHub Import** | Import any public repo via URL. Fetches zipball, extracts with JSZip |
-| 🎤 **Voice Commands** | Talk to Agdi! Uses Web Speech API for real-time transcription |
-| 🩹 **Self-Repair** | Autonomous build error recovery. AI diagnoses and fixes errors |
-| 🧠 **2026 Model Registry** | GPT-5.2 Codex, Claude 4.5 Sonnet, Gemini 3 Pro/Flash |
-| 🎨 **Official Brand Logos** | SVG icons for all AI providers (no more emojis) |
+### **IMPORTANT: Configure API Keys First**
+After installation, you **MUST** set up your API keys before using agdi:
+```bash
+agdi auth
+```
+This command will guide you through:
+1. Selecting your AI provider (Gemini, OpenAI, Anthropic, DeepSeek, OpenRouter, xAI)
+2. Entering your API key
+3. Choosing your default model
+### Start Coding
+```bash
+agdi
+```
+That's it! Start describing what you want to build.
 ---
-## 🎬 Cinematic Dark Mode
+## 🎯 Latest in v2.8.8
 <div align="center">
-  <img src="https://img.shields.io/badge/Premium_Terminal_UI-blueviolet?style=for-the-badge" alt="New">
+  <img src="https://img.shields.io/badge/NEW-xAI_Grok-00d1b2?style=for-the-badge" alt="xAI">
+  <img src="https://img.shields.io/badge/NEW-DeepSeek_Coder-ff6b6b?style=for-the-badge" alt="DeepSeek Coder">
+  <img src="https://img.shields.io/badge/UPDATED-All_2026_Models-8b5cf6?style=for-the-badge" alt="2026 Models">
 </div>
-### ✨ Visual Upgrade
+### ✨ What's New
-| Component | What It Looks Like |
-|-----------|-------------------|
-| **Neon Banner** | Cyan-to-Purple gradient ASCII art on startup |
-| **Glass Cards** | Rounded boxen panels for plans and status |
-| **Chat Bubbles** | `👤 YOU ›` and `⚡ AGDI ›` styled prompts |
-| **Security Alerts** | Red double-bordered warnings |
-| **Spinners** | Smooth cyan dots animation |
+| Update | Details |
+|--------|---------|
+| **xAI Provider** | NEW! Grok 3, Grok 2, Grok 2 Mini support |
+| **DeepSeek Coder** | Latest coding models: Coder V3 & V2.5 |
+| **Gemini 3** | Pro, Flash, Deep Think (Nov 2025) |
+| **GPT-5** | 5.2 (Flagship), 5.1, Codex variants |
+| **Claude 4.5** | Opus, Sonnet, Haiku (Nov 2025) |
+| **Multi-Line Input** | Paste long prompts easily |
+| **Clean UI** | Removed emojis for professional look |
-### 🖥️ Startup Experience
+---
-```
-┌──────────────────────────────────────────────────────────────┐
-│                                                              │
-│      ___   __________  ____                                  │
-│     /   | / ____/ __ \/  _/      ← Neon Gradient             │
-│    / /| |/ / __/ / / // /                                    │
-│   / ___ / /_/ / /_/ // /                                     │
-│  /_/  |_\____/_____/___/                                     │
-│                                                              │
-│           v2.7.0 [ARCHITECT ONLINE]                          │
-│                                                              │
-├──────────────────────────────────────────────────────────────┤
-│ ╭─ SESSION INFO ─────────────────────────────────────────╮   │
-│ │                                                        │   │
-│ │  Model:     gemini-2.5-flash                           │   │
-│ │  Workspace: ~/projects/my-app                          │   │
-│ │  Context:   Git Repository                             │   │
-│ │                                                        │   │
-│ ╰────────────────────────────────────────────────────────╯   │
-│                                                              │
-│ ──────────────────────────────────────────────────────────── │
-│                                                              │
-│ 👤 YOU › create a dashboard with charts                      │
-│                                                              │
-│ ⚡ AGDI ›                                                     │
-│ I'll create a modern dashboard with Recharts...              │
-│                                                              │
-└──────────────────────────────────────────────────────────────┘
-```
+## 🤖 Supported AI Providers
+agdi supports **6 AI providers** with the latest 2026 models:
+### 1. Google Gemini (Recommended - Free Tier)
+- Gemini 3 Pro (Most Intelligent)
+- Gemini 3 Flash (Fast)
+- Gemini 3 Deep Think (Reasoning)
+- Gemini 2.5 Pro/Flash
+- Get key: https://aistudio.google.com/apikey
+### 2. OpenAI
+- GPT-5.2 (Flagship), Instant, Thinking, Codex
+- GPT-5.1, Instant, Codex Max
+- GPT-4o, 4o Mini, o1, o1-mini
+- Get key: https://platform.openai.com/api-keys
+### 3. Anthropic
+- Claude Opus 4.5 (Most Intelligent)
+- Claude Sonnet 4.5, Haiku 4.5
+- Claude 3.5 Sonnet/Haiku
+- Get key: https://console.anthropic.com/
+### 4. DeepSeek
+- DeepSeek V3
+- DeepSeek R1 (Reasoning)
+- DeepSeek Coder V3 (NEW - Coding Specialist)
+- DeepSeek Coder V2.5
+- Get key: https://platform.deepseek.com/
+### 5. xAI (NEW!)
+- Grok 3 (Latest)
+- Grok 2
+- Grok 2 Mini
+- Get key: https://console.x.ai/
+### 6. OpenRouter
+- 100+ models from multiple providers
+- Free models available
+- Get key: https://openrouter.ai/keys
 ---
-## ⚡ Quick Start
+## 📖 Usage Guide
+### Basic Commands
 ```bash
-npm install -g agdi
+# Start interactive coding mode
 agdi
-```
----
+# Configure/change API keys
+agdi auth
-## 🎯 Highlights
+# Change model
+agdi model
-<table>
-<tr>
-<td width="50%">
+# Build specific app
+agdi build "create a todo app"
-### 🤖 Multi-Agent System
-```bash
-→ /agent
-🤖 Multi-agent mode: ON
-   Planner → Coder → Reviewer
+# Chat mode
+agdi chat
+# Help
+agdi --help
 ```
-Your code is reviewed by AI before delivery.
-</td>
-<td width="50%">
+### Advanced Options
-### 🎤 Voice Input (NEW)
 ```bash
-🎤 Hold Space to talk
-🎤 "Build a todo app with dark mode"
-→ Generating...
-```
-Talk to build apps!
+# Auto-approve all prompts (CI/CD mode)
+agdi --yes
-</td>
-</tr>
-<tr>
-<td width="50%">
+# Generate minimal files only
+agdi --minimal "create a utility function"
-### 🐙 GitHub Import (NEW)
-```bash
-→ Import from: https://github.com/user/repo
-📦 Fetching zipball...
-✓ Imported 47 files
+# Dry run (preview without creating)
+agdi --dry-run "build a landing page"
+# System health check
+agdi doctor
 ```
-</td>
-<td width="50%">
+### Slash Commands (In Interactive Mode)
-### 🩹 Self-Repair (NEW)
 ```bash
-❌ npm install failed
-🩹 Diagnosing error...
-🔧 Applying fix: removed conflicting dep
-✅ Build succeeded!
+/status    # Show git status with AI summary
+/diff      # Show git diff with AI explanation
+/commit    # Generate AI commit message
+/build     # Create new files/features
+/edit      # Modify existing files
+/help      # Show all commands
+/exit      # Exit agdi
 ```
-</td>
-</tr>
-</table>
 ---
-## 📋 Commands
-| Command | Description |
-|---------|-------------|
-| `/build <prompt>` | Generate & execute an application |
-| `/edit <file>` | AI-powered surgical file editing |
-| `/index` | Index project for semantic search |
-| `/search <query>` | Search codebase with AI |
-| `/agent` | Toggle multi-agent mode |
-| `/tools` | List MCP tools |
-| `/memory` | View persistent memory |
-| `/status` | AI git status analysis |
-| `/diff` | AI change explanation |
-| `/commit` | Auto-generate commit message |
-| `/clear` | Clear conversation |
-| `/history` | Show recent messages |
-| `/model` | Change AI model |
-| `/help` | Show all commands |
-| `/exit` | Exit Agdi |
----
+## 🎬 Terminal Experience
-## 🤖 Multi-Agent Pipeline
+### Clean, Professional UI
 ```
-┌─────────────────────────────────────────────────────────────┐
-│  📋 PLANNER AGENT                                           │
-│  Analyzes request → Creates step-by-step plan               │
-└─────────────────────────────┬───────────────────────────────┘
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  💻 CODER AGENT                                             │
-│  Writes production-ready TypeScript/React code              │
-└─────────────────────────────┬───────────────────────────────┘
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  🔍 REVIEWER AGENT                                          │
-│  • Correctness  • Security  • Performance                   │
-│                                                             │
-│  ✅ APPROVED → Delivered to user                            │
-│  ⚠️ NEEDS_CHANGES → Back to CODER (max 3 loops)             │
-└─────────────────────────────────────────────────────────────┘
+    ___   __________  ____
+   /   | / ____/ __ \/  _/
+  / /| |/ / __/ / / // /
+ / ___ / /_/ / /_/ // /
+/_/  |_\____/_____/___/
+      v2.8.8 [ARCHITECT ONLINE]
+   ╭ SESSION INFO ─────────────────────────────╮
+   │                                           │
+   │   Model:     gemini-3-pro-preview         │
+   │   Workspace: ~/projects/my-app            │
+   │   Context:   Local Folder                 │
+   │                                           │
+   ╰───────────────────────────────────────────╯
+👤 YOU › create a modern landing page
+   ╭ PLAN: landing-page ────────╮
+   │                            │
+   │   📁 Create 2 directories  │
+   │   📄 Create 8 files        │
+   │   ⚡ Run 2 commands         │
+   │                            │
+   ╰────────────────────────────╯
 ```
 ---
-## 🛡️ Zero-Trust Security
-### Permission Tiers
+## 🛡️ Security Features
-| Tier | Risk | Examples | Default |
-|------|------|----------|---------|
-| 0 | Read-only | `ls`, `cat`, `git status` | Auto-approve |
-| 1 | Workspace | `touch`, `mkdir`, `git commit` | Prompt once |
-| 2 | System | `npm install`, `docker run` | Always prompt |
-| 3 | Dangerous | `sudo`, `rm -rf`, `curl\|bash` | Block |
+### Workspace Trust
+- Prompts before executing commands outside workspace
+- Prevents accidental system modifications
+- Audit logging of all dangerous operations
-### Security Alert (v2.6.1 Style)
+### Dangerous Command Detection
+- Detects risky commands (rm, curl, wget, eval)
+- Requires explicit confirmation
+- Shows command preview before execution
-```
-╔══════════════════════════════════════════════════════════════╗
-║ 🛡️  UNTRUSTED WORKSPACE                                      ║
-╠══════════════════════════════════════════════════════════════╣
-║                                                              ║
-║   The agent wants to execute 5 actions in this folder.       ║
-║   This includes writing files and/or running commands.       ║
-║                                                              ║
-║   Target: /Users/dev/projects/my-app                         ║
-║                                                              ║
-╚══════════════════════════════════════════════════════════════╝
-? Trust this workspace?
-❯ Trust for this session
-  Trust and remember
-  Cancel
-```
+### API Key Security
+- Stored securely in `~/.agdi/config.json`
+- File permissions: 0600 (owner read/write only)
+- Never exposed in logs or output
 ---
-## 🌐 AI Providers
+## 🎯 Use Cases
-### Free Models via OpenRouter
-> **Note:** These models are free but require an [OpenRouter API key](https://openrouter.ai/keys) (free to create).
+### Web Development
+```bash
+agdi build "create a Next.js blog with MDX support"
+```
-| Model | ID | Best For |
-|-------|-----|----------|
-| GPT-OSS 120B | `openai/gpt-oss-120b:free` | General |
-| Qwen3 Coder | `qwen/qwen3-coder:free` | Code |
-| Kimi K2 | `moonshotai/kimi-k2:free` | General |
-| Gemma 3n | `google/gemma-3n-e2b-it:free` | Lightweight |
-| Devstral | `mistralai/devstral-2512:free` | Code |
+### API Development
+```bash
+agdi build "RESTful API with Express and MongoDB"
+```
-### Bring Your Own Key
+### Utilities
+```bash
+agdi --minimal "write a JSON to CSV converter"
+```
-| Provider | Models | Get Key |
-|----------|--------|---------|
-| **Gemini** 🔥 | Gemini 3 Pro/Flash, 2.5 Flash | [aistudio.google.com](https://aistudio.google.com/apikey) |
-| **OpenRouter** | Claude, GPT-5, Llama | [openrouter.ai](https://openrouter.ai/keys) |
-| **OpenAI** | GPT-5.2 Codex, o3 | [platform.openai.com](https://platform.openai.com/api-keys) |
-| **Anthropic** | Claude 4.5 Sonnet/Opus | [console.anthropic.com](https://console.anthropic.com/) |
+### Debugging
+```bash
+agdi chat
+> "Why is my React component not re-rendering?"
+```
 ---
-## ⚙️ Configuration
+## 🔧 Configuration
+### API Key Management
+```bash
+# First-time setup
+agdi auth
+# Change provider
+agdi model
+# View current config
+cat ~/.agdi/config.json
 ```
-~/.agdi/
-├── config.json              # API keys & settings
-├── rules.json               # Permission rules
-├── trusted-workspaces.json  # Trusted directories
-├── memory/                  # Persistent memory
-│   └── store.json
-├── indexes/                 # RAG indexes
-└── audit.jsonl              # Audit log
+### Configuration File Location
+- **macOS/Linux**: `~/.agdi/config.json`
+- **Windows**: `C:\Users\<YourName>\.agdi\config.json`
+### Example Config
+```json
+{
+  "geminiApiKey": "AIza...",
+  "defaultProvider": "gemini",
+  "defaultModel": "gemini-3-pro-preview"
+}
 ```
 ---
-## 📊 Quality Metrics
+## 📋 System Requirements
-<div align="center">
+- **Node.js**: 18.x or higher
+- **npm**: 9.x or higher
+- **OS**: macOS, Linux, Windows
+- **Terminal**: Any modern terminal (supports UTF-8)
-| Metric | Value |
-|--------|-------|
-| TypeScript Errors | **0** |
-| Tests Passing | **60** |
-| Build Size | **150 KB** |
-| Security Patterns | **22+** |
-| Weekly Downloads | **900+** |
+---
-</div>
+## 🆘 Troubleshooting
----
+### "Command not found: agdi"
+```bash
+npm install -g agdi
+# Ensure ~/.npm-global/bin is in your PATH
+```
-## 📦 Tech Stack
+### "No API key configured"
+```bash
+agdi auth
+# Follow the prompts to set up your API key
+```
+### "Permission denied" (macOS/Linux)
+```bash
+sudo npm install -g agdi
+# Or configure npm global without sudo:
+# https://docs.npmjs.com/resolving-eacces-permissions-errors
+```
-- **Runtime**: Node.js 18+
-- **Language**: TypeScript 5.4
-- **CLI**: Commander, Inquirer
-- **UI**: Chalk, Ora, Boxen, Gradient-string, Figlet
-- **Build**: tsup
-- **Testing**: Vitest
+### TypeScript Errors
+```bash
+# Clear and rebuild
+rm -rf node_modules package-lock.json
+npm install
+```
 ---
-## 🔗 Links
+## 🤝 Contributing
-- 🌐 [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
-- 📦 [npmjs.com/package/agdi](https://www.npmjs.com/package/agdi)
-- 🐙 [github.com/anassagd432/Agdi-dev](https://github.com/anassagd432/Agdi-dev)
+We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md).
 ---
 ## 📄 License
-MIT © [Agdi Systems Inc.](https://agdi-dev.vercel.app)
+MIT © 2026 Agdi
 ---
-<div align="center">
+## 🔗 Links
-**Built with ❤️ by [Anass Agdi](https://github.com/anassagd432)**
+- 🌐 [Website](https://agdi-dev.vercel.app)
+- 📦 [npm Package](https://www.npmjs.com/package/agdi)
+- 💻 [GitHub](https://github.com/anassagd432/Agdi-dev)
+- 📧 [Issues](https://github.com/anassagd432/Agdi-dev/issues)
-⭐ **Star on GitHub** if you find this useful!
+---
+<div align="center">
+  <sub>Built with ❤️ by the Agdi team</sub>
 </div>

package/bin/agdi.js CHANGED Viewed

@@ -1,2 +1,7 @@
 #!/usr/bin/env node
-import '../dist/index.js';
+// ES module dynamic import for bin executable
+import('../dist/index.js').catch(err => {
+    console.error('Failed to load agdi:', err);
+    process.exit(1);
+});

package/dist/index.js CHANGED Viewed

@@ -989,7 +989,8 @@ async function login() {
         { name: "OpenAI (GPT-4, GPT-5)", value: "openai" },
         { name: "Anthropic (Claude)", value: "anthropic" },
         { name: "DeepSeek", value: "deepseek" },
-        { name: "Local LLM (Ollama)", value: "ollama" }
+        { name: "Local LLM (Ollama)", value: "ollama" },
+        { name: "Search API (Brave/Perplexity - for DeepSearch)", value: "search" }
       ]
     });
     if (provider === "ollama") {
@@ -1025,6 +1026,25 @@ async function login() {
       case "openrouter":
         config.openrouterApiKey = apiKey;
         break;
+      case "search": {
+        const searchProvider = await select({
+          message: "Select search provider:",
+          choices: [
+            { name: "Brave Search (Recommended - Free 2k/month)", value: "brave" },
+            { name: "Perplexity API", value: "perplexity" },
+            { name: "Tavily", value: "tavily" }
+          ]
+        });
+        config.searchProvider = searchProvider;
+        config.searchApiKey = apiKey;
+        config.searchEnabled = true;
+        config.searchAutoTrigger = true;
+        console.log(chalk5.green(`
+\u2705 ${searchProvider} API key saved for DeepSearch`));
+        console.log(chalk5.gray("DeepSearch enabled - will automatically search for latest docs\n"));
+        saveConfig(config);
+        return;
+      }
     }
     config.defaultProvider = provider;
     saveConfig(config);
@@ -4914,7 +4934,7 @@ ${chalk15.cyan(`/_/  |_|\\_, /\\__,_//_/    `)}
 ${chalk15.cyan(`       /____/              `)}
 `;
 var program = new Command();
-program.name("agdi").description(chalk15.cyan("\u{1F680} AI-powered coding assistant")).version("2.8.8").option("-y, --yes", "Auto-approve all prompts (headless/CI mode)").option("-m, --minimal", "Generate only the requested file(s), not a full app").option("-d, --dry-run", "Show what would be created without writing files");
+program.name("agdi").description(chalk15.cyan("\u{1F680} AI-powered coding assistant")).version("2.9.0").option("-y, --yes", "Auto-approve all prompts (headless/CI mode)").option("-m, --minimal", "Generate only the requested file(s), not a full app").option("-d, --dry-run", "Show what would be created without writing files");
 program.hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.yes) {

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
     "name": "agdi",
-    "version": "2.8.8",
+    "version": "2.9.0",
     "description": "AI-powered app generator - build full-stack apps from natural language in your terminal",
     "type": "module",
     "bin": {
@@ -46,6 +46,7 @@
         "node": ">=18.0.0"
     },
     "devDependencies": {
+        "@types/file-saver": "^2.0.7",
         "@types/fs-extra": "^11.0.0",
         "@types/node": "^20.0.0",
         "tsup": "^8.0.0",
@@ -54,10 +55,15 @@
         "vitest": "^3.0.0"
     },
     "dependencies": {
+        "@babel/core": "^7.28.6",
+        "@babel/parser": "^7.28.6",
+        "@babel/traverse": "^7.28.6",
+        "@babel/types": "^7.28.6",
         "@google/genai": "^1.0.0",
         "@inquirer/prompts": "^5.0.0",
         "@types/figlet": "^1.7.0",
         "@types/gradient-string": "^1.1.6",
+        "better-sqlite3": "^12.6.2",
         "boxen": "^8.0.1",
         "chalk": "^5.3.0",
         "commander": "^12.0.0",