agdi 3.3.7 → 3.4.0

package/README.md

@@ -1,160 +1,94 @@
-# Agdi CLI — The Autonomous AI Employee
+# agdi — AI-Powered App Generator
 
-<div align="center">
-  <img src="https://agdi-dev.vercel.app/logo.svg" alt="Agdi Logo" width="120" height="120">
-  
-  # 🦸 AGDI
-  ### The Autonomous AI Software Squad in Your Terminal
-  #### v3.3.0: New Mission Control TUI
+Build full-stack web applications from natural language in your terminal.
 
-  [![npm version](https://img.shields.io/npm/v/agdi.svg?style=for-the-badge&logo=npm&color=cyan)](https://www.npmjs.com/package/agdi)
-  [![License](https://img.shields.io/npm/l/agdi.svg?style=for-the-badge&color=blue)](https://github.com/anassagd432/Agdi-dev)
-  [![Downloads](https://img.shields.io/npm/dt/agdi.svg?style=for-the-badge&color=purple)](https://www.npmjs.com/package/agdi)
-
-  <p align="center">
-    <b>Build, Test, and Deploy Full-Stack SaaS Apps with a Single Prompt.</b><br>
-    Powered by Gemini 3, GPT-5, and Claude 4.5.
-  </p>
-</div>
-
----
-
-## ⚡ What is Agdi?
-
-Agdi isn't just a code generator. It's an **autonomous software agency** that lives in your terminal. When you give it a prompt, it doesn't just spit out code—it spins up a **Squad** of specialized AI agents that work together:
-
-- **🧠 The Manager:** Plans the architecture, breaks down tasks, and oversees the project.
-- **🎨 The Designer:** Builds beautiful, responsive UI components (React + Tailwind + Shadcn).
-- **⚙️ The Engineer:** Implements secure APIs, database schemas, and backend logic.
-- **🕵️ The QA:** Runs builds, writes tests, detects errors, and **auto-fixes** them before you ever see the code.
-- **🚀 The DevOps:** Handles deployment to Vercel/Netlify automatically.
-
----
-
-## 🚀 Getting Started
-
-### 1. Install via npm
 ```bash
 npm install -g agdi
 ```
 
-### 2. Run the Wizard
-The easiest way to start is the interactive wizard. It will guide you through authentication and project setup.
-```bash
-agdi
-```
+## Quick Start
 
-### 3. Build a SaaS in Seconds
-Want to go fast? Use the direct build command:
 ```bash
-agdi build "A project management tool with Kanban boards and team chat"
-```
-
----
+# 1. Configure your API keys
+agdi auth
 
-## 🛠️ Features
+# 2. Generate an app
+agdi build "A kanban board with drag-and-drop"
 
-### 🏢 The SaaS Blueprint (`--saas`)
-Generate a production-ready SaaS foundation instantly:
-- **Framework:** Next.js 15 (App Router)
-- **Database:** Prisma + PostgreSQL
-- **Auth:** Clerk / NextAuth
-- **Payments:** Stripe Subscription integration
-- **Styling:** Tailwind CSS + Shadcn UI
-
-```bash
-agdi build "AI-powered CRM for real estate agents" --saas
+# 3. Or use the full multi-agent squad
+agdi squad "SaaS dashboard with auth and Stripe billing"
 ```
 
-### 🔄 Auto-Healing Code
-Agdi's QA agent runs in a loop. If the build fails:
-1. It analyzes the error logs.
-2. It reads the source code.
-3. It generates a surgical fix.
-4. It re-runs the build.
-*You get working code, not error messages.*
-
-### 📦 Import & Refactor
-Have an existing repo? Import it and ask Agdi to add features.
-```bash
-agdi import https://github.com/user/repo
-```
+## Requirements
 
----
+- **Node.js** ≥ 20.0.0
+- At least one AI API key:
+  - [Google Gemini](https://aistudio.google.com/apikey) (recommended)
+  - [OpenRouter](https://openrouter.ai/keys) (100+ models)
+  - [OpenAI](https://platform.openai.com/api-keys)
+  - [Anthropic](https://console.anthropic.com/)
+  - [DeepSeek](https://platform.deepseek.com/)
 
-## 🤖 Supported Models
+## Commands
 
-Agdi supports the absolute bleeding edge of AI models via a unified interface:
+| Command | Description |
+|---------|-------------|
+| `agdi` | Launch interactive TUI dashboard |
+| `agdi build <prompt>` | Generate an app from a prompt |
+| `agdi build <prompt> --saas` | SaaS blueprint (Next.js + Prisma + Stripe) |
+| `agdi squad [prompt]` | Multi-agent autonomous build |
+| `agdi squad --deploy` | Build and deploy to Vercel |
+| `agdi chat` | Interactive AI chat session |
+| `agdi auth` | Configure API keys |
+| `agdi config` | Show current configuration |
+| `agdi doctor` | Environment health check |
+| `agdi import <url>` | Import a GitHub repository |
 
-| Provider | Models Supported | Best For |
-|----------|------------------|----------|
-| **Google** | Gemini 3 Pro, 2.5 Flash | **Speed & Context** (Recommended) |
-| **OpenAI** | GPT-5, GPT-4o, o1 | **Complex Logic** |
-| **Anthropic** | Claude 3.5 Sonnet, Opus | **Coding & Architecture** |
-| **DeepSeek** | DeepSeek V3, R1 | **Reasoning & Cost Efficiency** |
-| **OpenRouter**| 100+ Models | **Flexibility** |
+## How It Works
 
----
+Agdi uses a **multi-agent architecture** with specialized agents:
 
-## ⚙️ Advanced Usage
+1. **Manager** — analyzes your request and creates a spec
+2. **Frontend** — generates React + Tailwind components
+3. **Backend** — writes server logic and database schemas
+4. **DevOps** — configures CI/CD and deployment
+5. **QA** — tests the output, auto-fixes errors (up to 3 retries)
 
-### Squad Mode (Multi-Agent)
-For complex projects, invoke the full squad explicitly:
-```bash
-agdi squad "Crypto portfolio tracker with real-time websocket updates"
-```
+The CLI also indexes your existing codebase using **AST parsing** and **vector embeddings** for deep context understanding.
 
-### Config Management
-View or edit your API keys and settings:
-```bash
-agdi config
-```
-Enable telemetry to help us debug crashes (fully anonymous):
-```bash
-agdi config telemetry --enable
-```
+## Configuration
 
-### Semantic Search (Optional)
-Agdi can optionally enable local semantic embeddings for smarter context retrieval.
+API keys are stored in `~/.agdi/config.json` (created via `agdi auth`).
 
-Enable via environment variable:
 ```bash
-AGDI_SEMANTIC_SEARCH=1 agdi
-```
+# Check your setup
+agdi doctor
 
-Or enable permanently in `~/.agdi/config.json`:
-```json
-{ "semanticSearchEnabled": true }
+# View current config
+agdi config
 ```
 
----
-
-## 🛡️ Security
+## Security
 
-Agdi takes security seriously.
-- **Zero-Trust:** It never executes dangerous shell commands without permission (unless `--yes` is used).
-- **Local Keys:** API keys are stored in `~/.agdi/config.json` with `0600` permissions (readable only by you).
-- **Sandboxed:** Code generation happens in your specified directory, never outside it.
+- **Code Firewall** — scans AI-generated code for `eval()`, injection, and hardcoded secrets before writing to disk
+- **Permission Gate** — zero-trust model, all shell commands require explicit approval
+- **Audit Logger** — logs every operation to `~/.agdi/audit.log`
 
----
+## Common Issues
 
-## ❓ Troubleshooting
+| Issue | Solution |
+|-------|---------|
+| "No API key" | Run `agdi auth` to configure at least one provider |
+| Build fails | Run `agdi doctor` to check your environment |
+| Permission denied | Agdi requires explicit approval for file writes and shell commands |
 
-**"API Key Invalid"**
-Run `agdi auth` to re-enter your keys. Ensure your plan covers the model you selected.
+## Links
 
-**"Build Failed"**
-If the auto-healer gives up, check the logs in `runs/<id>/report.md`. You can often fix the small typo manually and run `npm run dev`.
-
-**"Quota Exceeded"**
-Switch to a cheaper model or provider:
-```bash
-agdi model
-```
+- **Web IDE**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
+- **GitHub**: [github.com/anassagd432/Agdi-dev](https://github.com/anassagd432/Agdi-dev)
+- **Discord**: [discord.gg/pPkZ93Yb](https://discord.gg/pPkZ93Yb)
+- **Issues**: [GitHub Issues](https://github.com/anassagd432/Agdi-dev/issues)
 
----
+## License
 
-<div align="center">
-  <p>Built with ❤️ by Agdi Systems Inc.</p>
-  <p>2026 Edition</p>
-</div>
+MIT © Anass Agdi