agdi 3.4.4 → 4.0.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 (3) hide show
  1. package/README.md +85 -71
  2. package/dist/index.js +2127 -488
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,100 +1,114 @@
1
- # agdi — AI-Powered App Generator
1
+ <div align="center">
2
2
 
3
- Build full-stack web applications from natural language in your terminal.
3
+ # ⚡ agdi
4
4
 
5
- ```bash
6
- npm install -g agdi
7
- ```
5
+ **The Autonomous AI Software Engineer in your terminal.**<br>
6
+ Build full-stack, production-ready applications from natural language prompts.
7
+
8
+ [![NPM Version](https://img.shields.io/npm/v/agdi?style=for-the-badge&color=cyan)](https://www.npmjs.com/package/agdi)
9
+ [![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](https://github.com/anassagd432/Agdi-dev/blob/main/LICENSE)
10
+ [![Node](https://img.shields.io/node/v/agdi?style=for-the-badge&color=brightgreen)](https://nodejs.org)
11
+ [![Discord](https://img.shields.io/discord/1337421838189658245?style=for-the-badge&label=Discord&logo=discord&logoColor=white&color=7289da)](https://discord.gg/pPkZ93Yb)
12
+
13
+ </div>
14
+
15
+ ---
16
+
17
+ **agdi** doesn't just write boilerplate. It operates as an autonomous squad of AI engineers that plans architecture, writes code, tests it, self-heals errors, and deploys—all without human intervention.
18
+
19
+ Equipped with **Deep Context Indexing**, it understands your existing codebase through AST parsing and local semantic vector search before it writes a single line of code.
20
+
21
+ <br>
8
22
 
9
- ## Quick Start
23
+ ## 🚀 Quick Start
24
+
25
+ Get started in seconds. No complex setup required.
10
26
 
11
27
  ```bash
12
- # 1. Configure your API keys
13
- agdi auth
28
+ # 1. Install globally
29
+ npm install -g agdi
14
30
 
15
- # 2. Generate a standard app
16
- agdi build "A kanban board with drag-and-drop"
31
+ # 2. Configure your API keys (Gemini, Anthropic, OpenAI, etc.)
32
+ agdi auth
17
33
 
18
- # 3. Generate a production SaaS blueprint (Next.js + Prisma + Stripe)
19
- agdi build "Task management platform" --saas
34
+ # 3. Generate a beautiful Kanban board
35
+ agdi build "A modern kanban board with drag-and-drop using Tailwind"
20
36
 
21
- # 4. Or use the full multi-agent squad
22
- agdi squad "SaaS dashboard with auth and Stripe billing"
37
+ # 4. Or use the full autonomous squad for complex SaaS
38
+ agdi squad "Task management platform with Stripe billing and Supabase auth"
23
39
  ```
24
40
 
25
- ## Requirements
41
+ ---
26
42
 
27
- - **Node.js** ≥ 20.0.0
28
- - At least one AI API key:
29
- - [Google Gemini](https://aistudio.google.com/apikey) (recommended)
30
- - [OpenRouter](https://openrouter.ai/keys) (100+ models)
31
- - [OpenAI](https://platform.openai.com/api-keys)
32
- - [Anthropic](https://console.anthropic.com/)
33
- - [DeepSeek](https://platform.deepseek.com/)
43
+ ## ✨ Why Agdi?
34
44
 
35
- ## Commands
45
+ | Capability | Description |
46
+ |---|---|
47
+ | 🤖 **Multi-Agent Squad** | Dedicated Manager, Frontend, Backend, DevOps, and QA agents working in parallel. |
48
+ | 🧠 **Deep Context Engine** | Scans your repository, parses TypeScript ASTs, and uses local vector embeddings to understand your architecture. |
49
+ | 🛠️ **SaaS Blueprint** | `agdi build --saas` instantly generates a Next.js App Router project with Prisma, Postgres, Auth, and Stripe. |
50
+ | 🛡️ **Zero-Trust Security** | Code Firewall prevents `eval()` injections and hardcoded secrets. Permission Gate requires your approval for shell executions. |
51
+ | 🌐 **Omnichannel** | Control your CLI agent from anywhere via Slack, Discord, or Telegram (`agdi channels`). |
52
+ | 📡 **Native Gateway** | Real-time WebSocket connection for streaming metrics and remote execution control. |
36
53
 
37
- | Command | Alias | Description |
38
- |---------|-------|-------------|
39
- | `agdi` | — | Launch the minimal interactive TUI dashboard |
40
- | `agdi build <prompt>` | `b` | Generate an app from a prompt |
41
- | `agdi build <prompt> --saas` | — | Generate a SaaS blueprint (Next.js + Prisma + Stripe) |
42
- | `agdi squad [prompt]` | `s` | Multi-agent autonomous build with parallel execution |
43
- | `agdi squad --deploy` | — | Build and auto-deploy to Vercel/Netlify |
44
- | `agdi gateway` | `gw` | Start or check the WebSocket native gateway |
45
- | `agdi channels` | — | Manage omnichannel integrations (Slack, Discord, Telegram) |
46
- | `agdi auth` | — | Configure API keys securely |
47
- | `agdi doctor` | `doc` | Environment health check and diagnostics |
48
- | `agdi import <url>` | `i` | Import and scaffold a GitHub repository |
54
+ ---
49
55
 
50
- ## How It Works
56
+ ## ⌨️ Command Reference
51
57
 
52
- Agdi uses a **multi-agent architecture** with specialized agents:
58
+ A clean, minimal Terminal User Interface (TUI) powers your experience.
53
59
 
54
- 1. **Manager** — analyzes your request and creates a spec
55
- 2. **Frontend** — generates React + Tailwind components
56
- 3. **Backend** — writes server logic and database schemas
57
- 4. **DevOps** — configures CI/CD and zero-touch deployment (Vercel/Netlify)
58
- 5. **QA** — tests the output, auto-fixes errors (up to 3 retries)
60
+ | Command | Alias | What it does |
61
+ |---------|-------|-------------|
62
+ | `agdi` | — | Launch the beautiful, interactive TUI dashboard |
63
+ | `agdi build <prompt>` | `b` | Generate or edit an app from a prompt |
64
+ | `agdi build <prompt> --saas` | — | Generate a full-stack SaaS blueprint |
65
+ | `agdi squad [prompt]` | `s` | Trigger the multi-agent autonomous builder |
66
+ | `agdi squad --deploy` | — | Build and auto-deploy directly to Vercel/Netlify |
67
+ | `agdi squad --breakpoints` | — | Pause after each agent task for review |
68
+ | `agdi audit --prod` | — | Production readiness scanner (a11y, security, tests) |
69
+ | `agdi sandbox <url>` | — | Live API doc reader and endpoint tester |
70
+ | `agdi visual-test` | `vt` | Screenshot regression testing against baselines |
71
+ | `agdi memory` | `mem` | Parse git history for project context & patterns |
72
+ | `agdi deps --full` | — | Scan dependencies for vulnerabilities and auto-fix |
73
+ | `agdi plugins` | `plug` | Manage community plugins and IDE extensions |
74
+ | `agdi gateway` | `gw` | Start or check the native WebSocket gateway |
75
+ | `agdi channels` | — | Link agdi to your Slack, Discord, or Telegram |
76
+ | `agdi auth` | — | Securely configure your BYOK (Bring Your Own Key) access |
77
+ | `agdi doctor` | `doc` | Run environment diagnostics and health checks |
78
+ | `agdi import <url>` | `i` | Clone and auto-scaffold a GitHub repository |
59
79
 
60
- The CLI features **Deep Context Indexing**:
61
- - **AST Parsing**: Understands Babel/TypeScript syntax, imports, and exports.
62
- - **Dependency Graphs**: Maps relationships between modules automatically.
63
- - **Vector Embeddings**: Uses local `@xenova/transformers` (MiniLM) for semantic code search.
80
+ ---
64
81
 
65
- ## Configuration
82
+ ## 🧠 Supported LLM Providers
66
83
 
67
- API keys are stored in `~/.agdi/config.json` (created via `agdi auth`).
84
+ Agdi routes tasks to the best model automatically or lets you choose your favorite via Bring-Your-Own-Key (BYOK):
68
85
 
69
- ```bash
70
- # Check your setup
71
- agdi doctor
86
+ - **Google** (Gemini 3 Pro, 3 Flash, 2.5 Flash) — *Recommended*
87
+ - **Anthropic** (Claude 4.5 Sonnet/Opus, 3.5 Sonnet)
88
+ - **OpenAI** (GPT-4.1, GPT-5.2 Codex)
89
+ - **DeepSeek** (DeepSeek V3, R1)
90
+ - **OpenRouter** (Access to 100+ models)
91
+ - **Meta** (Llama 4 Maverick)
92
+ - **Alibaba** (Qwen3 Coder)
72
93
 
73
- # View current config
74
- agdi config
75
- ```
94
+ *Keys are stored securely in `~/.agdi/config.json`. We never collect your keys.*
95
+
96
+ ---
76
97
 
77
- ## Security & Telemetry
98
+ ## 🔒 Security & Telemetry
78
99
 
79
- Agdi is built with a zero-trust architecture:
80
- - **Code Firewall** — scans AI-generated code for `eval()`, injection, and hardcoded secrets before writing to disk.
81
- - **Permission Gate** — all shell commands and file writes require explicit approval (unless explicitly skipped).
82
- - **Audit Logger** — logs every operation to `~/.agdi/audit.log`.
83
- - **Telemetry Transparency** — Opt-in telemetry. Run `agdi config telemetry --dry-run` to see exactly what is sent (never source code or keys).
100
+ Your code is your code. Agdi runs completely locally (aside from the LLM API calls).
84
101
 
85
- ## Common Issues
102
+ - **Code Firewall**: Every generated file is scanned for vulnerabilities before writing to disk.
103
+ - **Audit Logger**: All file modifications and shell commands are logged to `~/.agdi/audit.log`.
104
+ - **Telemetry Transparency**: Telemetry is opt-in and *never* contains source code. Run `agdi config telemetry --dry-run` to see exactly what is sent.
86
105
 
87
- | Issue | Solution |
88
- |-------|---------|
89
- | "No API key" | Run `agdi auth` to configure at least one provider |
90
- | Build fails | Run `agdi doctor` to check your environment |
91
- | Permission denied | Agdi requires explicit approval for file writes and shell commands |
106
+ ---
92
107
 
93
- ## Links
108
+ <div align="center">
94
109
 
95
- - **Web IDE**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
96
- - **Discord**: [discord.gg/pPkZ93Yb](https://discord.gg/pPkZ93Yb)
110
+ **[🌐 Web IDE](https://agdi-dev.vercel.app)** · **[💬 Join the Discord](https://discord.gg/pPkZ93Yb)** · **[🐛 Report a Bug](https://github.com/anassagd432/Agdi-dev/issues)**
97
111
 
98
- ## License
112
+ *Built with ❤️ for developers.*
99
113
 
100
- MIT © Anass Agdi
114
+ </div>