agdi 3.3.8 → 3.4.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 +61 -127
  2. package/dist/index.js +1 -1
  3. package/package.json +3 -3
package/README.md CHANGED
@@ -1,160 +1,94 @@
1
- # Agdi CLI — The Autonomous AI Employee
1
+ # agdi — AI-Powered App Generator
2
2
 
3
- <div align="center">
4
- <img src="https://agdi-dev.vercel.app/logo.svg" alt="Agdi Logo" width="120" height="120">
5
-
6
- # 🦸 AGDI
7
- ### The Autonomous AI Software Squad in Your Terminal
8
- #### v3.3.0: New Mission Control TUI
3
+ Build full-stack web applications from natural language in your terminal.
9
4
 
10
- [![npm version](https://img.shields.io/npm/v/agdi.svg?style=for-the-badge&logo=npm&color=cyan)](https://www.npmjs.com/package/agdi)
11
- [![License](https://img.shields.io/npm/l/agdi.svg?style=for-the-badge&color=blue)](https://github.com/anassagd432/Agdi-dev)
12
- [![Downloads](https://img.shields.io/npm/dt/agdi.svg?style=for-the-badge&color=purple)](https://www.npmjs.com/package/agdi)
13
-
14
- <p align="center">
15
- <b>Build, Test, and Deploy Full-Stack SaaS Apps with a Single Prompt.</b><br>
16
- Powered by Gemini 3, GPT-5, and Claude 4.5.
17
- </p>
18
- </div>
19
-
20
- ---
21
-
22
- ## ⚡ What is Agdi?
23
-
24
- 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:
25
-
26
- - **🧠 The Manager:** Plans the architecture, breaks down tasks, and oversees the project.
27
- - **🎨 The Designer:** Builds beautiful, responsive UI components (React + Tailwind + Shadcn).
28
- - **⚙️ The Engineer:** Implements secure APIs, database schemas, and backend logic.
29
- - **🕵️ The QA:** Runs builds, writes tests, detects errors, and **auto-fixes** them before you ever see the code.
30
- - **🚀 The DevOps:** Handles deployment to Vercel/Netlify automatically.
31
-
32
- ---
33
-
34
- ## 🚀 Getting Started
35
-
36
- ### 1. Install via npm
37
5
  ```bash
38
6
  npm install -g agdi
39
7
  ```
40
8
 
41
- ### 2. Run the Wizard
42
- The easiest way to start is the interactive wizard. It will guide you through authentication and project setup.
43
- ```bash
44
- agdi
45
- ```
9
+ ## Quick Start
46
10
 
47
- ### 3. Build a SaaS in Seconds
48
- Want to go fast? Use the direct build command:
49
11
  ```bash
50
- agdi build "A project management tool with Kanban boards and team chat"
51
- ```
52
-
53
- ---
12
+ # 1. Configure your API keys
13
+ agdi auth
54
14
 
55
- ## 🛠️ Features
15
+ # 2. Generate an app
16
+ agdi build "A kanban board with drag-and-drop"
56
17
 
57
- ### 🏢 The SaaS Blueprint (`--saas`)
58
- Generate a production-ready SaaS foundation instantly:
59
- - **Framework:** Next.js 15 (App Router)
60
- - **Database:** Prisma + PostgreSQL
61
- - **Auth:** Clerk / NextAuth
62
- - **Payments:** Stripe Subscription integration
63
- - **Styling:** Tailwind CSS + Shadcn UI
64
-
65
- ```bash
66
- agdi build "AI-powered CRM for real estate agents" --saas
18
+ # 3. Or use the full multi-agent squad
19
+ agdi squad "SaaS dashboard with auth and Stripe billing"
67
20
  ```
68
21
 
69
- ### 🔄 Auto-Healing Code
70
- Agdi's QA agent runs in a loop. If the build fails:
71
- 1. It analyzes the error logs.
72
- 2. It reads the source code.
73
- 3. It generates a surgical fix.
74
- 4. It re-runs the build.
75
- *You get working code, not error messages.*
76
-
77
- ### 📦 Import & Refactor
78
- Have an existing repo? Import it and ask Agdi to add features.
79
- ```bash
80
- agdi import https://github.com/user/repo
81
- ```
22
+ ## Requirements
82
23
 
83
- ---
24
+ - **Node.js** ≥ 20.0.0
25
+ - At least one AI API key:
26
+ - [Google Gemini](https://aistudio.google.com/apikey) (recommended)
27
+ - [OpenRouter](https://openrouter.ai/keys) (100+ models)
28
+ - [OpenAI](https://platform.openai.com/api-keys)
29
+ - [Anthropic](https://console.anthropic.com/)
30
+ - [DeepSeek](https://platform.deepseek.com/)
84
31
 
85
- ## 🤖 Supported Models
32
+ ## Commands
86
33
 
87
- Agdi supports the absolute bleeding edge of AI models via a unified interface:
34
+ | Command | Description |
35
+ |---------|-------------|
36
+ | `agdi` | Launch interactive TUI dashboard |
37
+ | `agdi build <prompt>` | Generate an app from a prompt |
38
+ | `agdi build <prompt> --saas` | SaaS blueprint (Next.js + Prisma + Stripe) |
39
+ | `agdi squad [prompt]` | Multi-agent autonomous build |
40
+ | `agdi squad --deploy` | Build and deploy to Vercel |
41
+ | `agdi chat` | Interactive AI chat session |
42
+ | `agdi auth` | Configure API keys |
43
+ | `agdi config` | Show current configuration |
44
+ | `agdi doctor` | Environment health check |
45
+ | `agdi import <url>` | Import a GitHub repository |
88
46
 
89
- | Provider | Models Supported | Best For |
90
- |----------|------------------|----------|
91
- | **Google** | Gemini 3 Pro, 2.5 Flash | **Speed & Context** (Recommended) |
92
- | **OpenAI** | GPT-5, GPT-4o, o1 | **Complex Logic** |
93
- | **Anthropic** | Claude 3.5 Sonnet, Opus | **Coding & Architecture** |
94
- | **DeepSeek** | DeepSeek V3, R1 | **Reasoning & Cost Efficiency** |
95
- | **OpenRouter**| 100+ Models | **Flexibility** |
47
+ ## How It Works
96
48
 
97
- ---
49
+ Agdi uses a **multi-agent architecture** with specialized agents:
98
50
 
99
- ## ⚙️ Advanced Usage
51
+ 1. **Manager** — analyzes your request and creates a spec
52
+ 2. **Frontend** — generates React + Tailwind components
53
+ 3. **Backend** — writes server logic and database schemas
54
+ 4. **DevOps** — configures CI/CD and deployment
55
+ 5. **QA** — tests the output, auto-fixes errors (up to 3 retries)
100
56
 
101
- ### Squad Mode (Multi-Agent)
102
- For complex projects, invoke the full squad explicitly:
103
- ```bash
104
- agdi squad "Crypto portfolio tracker with real-time websocket updates"
105
- ```
57
+ The CLI also indexes your existing codebase using **AST parsing** and **vector embeddings** for deep context understanding.
106
58
 
107
- ### Config Management
108
- View or edit your API keys and settings:
109
- ```bash
110
- agdi config
111
- ```
112
- Enable telemetry to help us debug crashes (fully anonymous):
113
- ```bash
114
- agdi config telemetry --enable
115
- ```
59
+ ## Configuration
116
60
 
117
- ### Semantic Search (Optional)
118
- Agdi can optionally enable local semantic embeddings for smarter context retrieval.
61
+ API keys are stored in `~/.agdi/config.json` (created via `agdi auth`).
119
62
 
120
- Enable via environment variable:
121
63
  ```bash
122
- AGDI_SEMANTIC_SEARCH=1 agdi
123
- ```
64
+ # Check your setup
65
+ agdi doctor
124
66
 
125
- Or enable permanently in `~/.agdi/config.json`:
126
- ```json
127
- { "semanticSearchEnabled": true }
67
+ # View current config
68
+ agdi config
128
69
  ```
129
70
 
130
- ---
131
-
132
- ## 🛡️ Security
71
+ ## Security
133
72
 
134
- Agdi takes security seriously.
135
- - **Zero-Trust:** It never executes dangerous shell commands without permission (unless `--yes` is used).
136
- - **Local Keys:** API keys are stored in `~/.agdi/config.json` with `0600` permissions (readable only by you).
137
- - **Sandboxed:** Code generation happens in your specified directory, never outside it.
73
+ - **Code Firewall** — scans AI-generated code for `eval()`, injection, and hardcoded secrets before writing to disk
74
+ - **Permission Gate** — zero-trust model, all shell commands require explicit approval
75
+ - **Audit Logger** — logs every operation to `~/.agdi/audit.log`
138
76
 
139
- ---
77
+ ## Common Issues
140
78
 
141
- ## ❓ Troubleshooting
79
+ | Issue | Solution |
80
+ |-------|---------|
81
+ | "No API key" | Run `agdi auth` to configure at least one provider |
82
+ | Build fails | Run `agdi doctor` to check your environment |
83
+ | Permission denied | Agdi requires explicit approval for file writes and shell commands |
142
84
 
143
- **"API Key Invalid"**
144
- Run `agdi auth` to re-enter your keys. Ensure your plan covers the model you selected.
85
+ ## Links
145
86
 
146
- **"Build Failed"**
147
- 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`.
148
-
149
- **"Quota Exceeded"**
150
- Switch to a cheaper model or provider:
151
- ```bash
152
- agdi model
153
- ```
87
+ - **Web IDE**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
88
+ - **GitHub**: [github.com/anassagd432/Agdi-dev](https://github.com/anassagd432/Agdi-dev)
89
+ - **Discord**: [discord.gg/pPkZ93Yb](https://discord.gg/pPkZ93Yb)
90
+ - **Issues**: [GitHub Issues](https://github.com/anassagd432/Agdi-dev/issues)
154
91
 
155
- ---
92
+ ## License
156
93
 
157
- <div align="center">
158
- <p>Built with ❤️ by Agdi Systems Inc.</p>
159
- <p>2026 Edition</p>
160
- </div>
94
+ MIT © Anass Agdi
package/dist/index.js CHANGED
@@ -6535,7 +6535,7 @@ async function runChannelsDoctorCommand() {
6535
6535
  });
6536
6536
  continue;
6537
6537
  }
6538
- let detailParts = [];
6538
+ const detailParts = [];
6539
6539
  let level = "ok";
6540
6540
  if (!hasCreds) {
6541
6541
  level = "warn";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agdi",
3
- "version": "3.3.8",
3
+ "version": "3.4.0",
4
4
  "description": "AI-powered app generator - build full-stack apps from natural language in your terminal",
5
5
  "type": "module",
6
6
  "bin": {
@@ -49,7 +49,7 @@
49
49
  "url": "https://github.com/anassagd432/Agdi-dev/issues"
50
50
  },
51
51
  "engines": {
52
- "node": ">=18.0.0"
52
+ "node": ">=20.0.0"
53
53
  },
54
54
  "devDependencies": {
55
55
  "@types/babel__traverse": "^7.28.0",
@@ -93,4 +93,4 @@
93
93
  "ts-node": "^10.9.2",
94
94
  "uuid": "^13.0.0"
95
95
  }
96
- }
96
+ }