agdi 2.9.0 → 2.10.0

package/README.md

@@ -1,349 +1,182 @@
-<div align="center">
+# Agdi CLI
 
-```
-      ___   __________  ____
-     /   | / ____/ __ \/  _/
-    / /| |/ / __/ / / // /  
-   / ___ / /_/ / /_/ // /   
-  /_/  |_\____/_____/___/   
-                            
-```
-
-# agdi
-
-### The AI-Powered Terminal Architect
-
-[![npm](https://img.shields.io/npm/v/agdi?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/agdi)
-[![downloads](https://img.shields.io/npm/dw/agdi?style=for-the-badge&logo=npm&color=4FC08D)](https://www.npmjs.com/package/agdi)
-[![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/)
+> 🦸 The Autonomous AI Development Team — Build, Test, and Deploy from a Single Prompt
 
-**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)
-
-</div>
+[![npm version](https://img.shields.io/npm/v/agdi.svg?style=flat-square)](https://www.npmjs.com/package/agdi)
+[![npm downloads](https://img.shields.io/npm/dw/agdi.svg?style=flat-square)](https://www.npmjs.com/package/agdi)
 
 ---
 
-## 🚀 Quick Start
-
-### Installation
+## Installation
 
 ```bash
 npm install -g agdi
 ```
 
-### **IMPORTANT: Configure API Keys First**
-
-After installation, you **MUST** set up your API keys before using agdi:
+## Quick Start
 
 ```bash
+# 1. Configure your API key (required)
 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
+# 2. Start building!
 agdi
 ```
 
-That's it! Start describing what you want to build.
-
----
-
-## 🎯 Latest in v2.8.8
-
-<div align="center">
-  <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>
-
-### ✨ What's New
-
-| 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 |
-
 ---
 
-## 🤖 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
+## Commands
 
----
-
-## 📖 Usage Guide
-
-### Basic Commands
+### `agdi` — Interactive Mode
+Start the AI coding assistant in your terminal.
 
 ```bash
-# Start interactive coding mode
 agdi
-
-# Configure/change API keys
-agdi auth
-
-# Change model
-agdi model
-
-# Build specific app
-agdi build "create a todo app"
-
-# Chat mode
-agdi chat
-
-# Help
-agdi --help
 ```
 
-### Advanced Options
+### `agdi squad` — Autonomous Multi-Agent Builder 🆕
+Activate the Agdi Squad — a team of AI agents that build complete apps.
 
 ```bash
-# Auto-approve all prompts (CI/CD mode)
-agdi --yes
-
-# Generate minimal files only
-agdi --minimal "create a utility function"
-
-# Dry run (preview without creating)
-agdi --dry-run "build a landing page"
-
-# System health check
-agdi doctor
+agdi squad "Build a todo app with authentication"
+agdi squad "Build a SaaS dashboard" --deploy
+agdi squad "Build a blog" --output ./my-blog
 ```
 
-### Slash Commands (In Interactive Mode)
+**Options:**
+- `--deploy` — Auto-deploy to Vercel/Netlify after build
+- `--output <dir>` — Specify output directory (default: `./`)
+- `--verbose` — Show detailed agent logs
+
+### `agdi build` — Single-Shot Build
+Generate an app from a prompt without interactive mode.
 
 ```bash
-/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
+agdi build "create a portfolio website"
+agdi build "REST API with Express" --output ./api
+agdi build "CLI tool in TypeScript" --minimal
 ```
 
----
-
-## 🎬 Terminal Experience
+### `agdi auth` — Configure Authentication
+Set up API keys for AI providers and deployment tokens.
 
-### Clean, Professional UI
-
-```
-    ___   __________  ____
-   /   | / ____/ __ \/  _/
-  / /| |/ / __/ / / // /
- / ___ / /_/ / /_/ // /
-/_/  |_\____/_____/___/
-
-      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         │
-   │                            │
-   ╰────────────────────────────╯
+```bash
+agdi auth           # Interactive setup
+agdi auth --status  # Show configured providers
 ```
 
----
-
-## 🛡️ Security Features
-
-### Workspace Trust
-- Prompts before executing commands outside workspace
-- Prevents accidental system modifications
-- Audit logging of all dangerous operations
-
-### Dangerous Command Detection
-- Detects risky commands (rm, curl, wget, eval)
-- Requires explicit confirmation
-- Shows command preview before execution
+**Supported Providers:**
+- Google Gemini (Recommended - Free tier)
+- OpenAI (GPT-5, o1)
+- Anthropic (Claude 4.5)
+- DeepSeek (V3, R1)
+- xAI (Grok 3)
+- OpenRouter (100+ models)
 
-### API Key Security
-- Stored securely in `~/.agdi/config.json`
-- File permissions: 0600 (owner read/write only)
-- Never exposed in logs or output
+**Deployment Tokens:**
+- Vercel
+- Netlify
 
----
-
-## 🎯 Use Cases
+### `agdi model` — Change AI Model
+Switch between AI providers and models.
 
-### Web Development
 ```bash
-agdi build "create a Next.js blog with MDX support"
+agdi model
 ```
 
-### API Development
-```bash
-agdi build "RESTful API with Express and MongoDB"
-```
+### `agdi chat` — Q&A Mode
+Simple question-and-answer mode.
 
-### Utilities
 ```bash
-agdi --minimal "write a JSON to CSV converter"
+agdi chat
 ```
 
-### Debugging
+### `agdi doctor` — System Check
+Run diagnostics and health checks.
+
 ```bash
-agdi chat
-> "Why is my React component not re-rendering?"
+agdi doctor
 ```
 
 ---
 
-## 🔧 Configuration
-
-### API Key Management
+## The Agdi Squad
 
-```bash
-# First-time setup
-agdi auth
+When you run `agdi squad`, a team of specialized AI agents works together:
 
-# Change provider
-agdi model
+| Agent | Role |
+|-------|------|
+| 🧠 **Manager** | Analyzes your prompt, creates project spec, delegates tasks |
+| 🎨 **Frontend** | Builds React/Next.js UI components and pages |
+| ⚙️ **Backend** | Creates APIs, database schemas (Prisma), server logic |
+| 🕵️ **QA** | Runs builds, tests, and auto-fixes errors |
+| 🚀 **DevOps** | Deploys to Vercel/Netlify (if `--deploy` is used) |
 
-# View current config
-cat ~/.agdi/config.json
+**Flow:**
+```
+Prompt → Manager → [Frontend + Backend] → QA → DevOps → Live URL
 ```
 
-### Configuration File Location
+---
+
+## Configuration
+
+Config file location:
 - **macOS/Linux**: `~/.agdi/config.json`
-- **Windows**: `C:\Users\<YourName>\.agdi\config.json`
+- **Windows**: `C:\Users\<You>\.agdi\config.json`
 
-### Example Config
+Example:
 ```json
 {
   "geminiApiKey": "AIza...",
   "defaultProvider": "gemini",
-  "defaultModel": "gemini-3-pro-preview"
+  "defaultModel": "gemini-3-pro-preview",
+  "vercelToken": "...",
+  "deploymentProvider": "vercel"
 }
 ```
 
 ---
 
-## 📋 System Requirements
-
-- **Node.js**: 18.x or higher
-- **npm**: 9.x or higher
-- **OS**: macOS, Linux, Windows
-- **Terminal**: Any modern terminal (supports UTF-8)
-
----
+## Interactive Mode Commands
 
-## 🆘 Troubleshooting
+When in interactive mode (`agdi`), use these slash commands:
 
-### "Command not found: agdi"
-```bash
-npm install -g agdi
-# Ensure ~/.npm-global/bin is in your PATH
-```
-
-### "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
-```
-
-### TypeScript Errors
-```bash
-# Clear and rebuild
-rm -rf node_modules package-lock.json
-npm install
-```
+| Command | Description |
+|---------|-------------|
+| `/status` | Git status with AI summary |
+| `/diff` | Git diff with AI explanation |
+| `/commit` | Generate AI commit message |
+| `/build` | Create new features |
+| `/edit` | Modify existing files |
+| `/help` | Show all commands |
 
 ---
 
-## 🤝 Contributing
+## Security
 
-We welcome contributions! Please see our [Contributing Guide](../../CONTRIBUTING.md).
+- **API Keys**: Stored with 0600 permissions (owner-only)
+- **Workspace Boundary**: Commands restricted to current directory
+- **Dangerous Commands**: Detected and require confirmation
+- **Audit Logging**: All operations logged for review
 
 ---
 
-## 📄 License
+## Requirements
 
-MIT © 2026 Agdi
+- Node.js 18+
+- npm 9+
 
 ---
 
-## 🔗 Links
+## Links
 
-- 🌐 [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)
+- 📦 **npm**: https://www.npmjs.com/package/agdi
+- 💻 **GitHub**: https://github.com/anassagd432/Agdi-dev
+- 🌐 **Web App**: https://agdi-dev.vercel.app
 
 ---
 
-<div align="center">
-  <sub>Built with ❤️ by the Agdi team</sub>
-</div>
+## License
+
+MIT © 2024-2026 Agdi