agdi 3.1.2 β 3.3.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.
- package/README.md +100 -64
- package/dist/index.js +385 -379
- package/package.json +13 -5
package/README.md
CHANGED
|
@@ -1,111 +1,147 @@
|
|
|
1
1
|
# Agdi CLI β The Autonomous AI Employee
|
|
2
2
|
|
|
3
3
|
<div align="center">
|
|
4
|
-
<img src="https://agdi-dev.vercel.app/logo.svg" alt="Agdi Logo" width="
|
|
4
|
+
<img src="https://agdi-dev.vercel.app/logo.svg" alt="Agdi Logo" width="120" height="120">
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
###
|
|
6
|
+
# π¦Έ AGDI
|
|
7
|
+
### The Autonomous AI Software Squad in Your Terminal
|
|
8
|
+
#### v3.3.0: New Mission Control TUI
|
|
9
|
+
|
|
10
|
+
[](https://www.npmjs.com/package/agdi)
|
|
11
|
+
[](https://github.com/anassagd432/Agdi-dev)
|
|
12
|
+
[](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
|
+
---
|
|
8
21
|
|
|
9
|
-
|
|
10
|
-
[](https://www.npmjs.com/package/agdi)
|
|
22
|
+
## β‘ What is Agdi?
|
|
11
23
|
|
|
12
|
-
|
|
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.
|
|
13
31
|
|
|
14
32
|
---
|
|
15
33
|
|
|
16
|
-
## π
|
|
34
|
+
## π Getting Started
|
|
17
35
|
|
|
36
|
+
### 1. Install via npm
|
|
18
37
|
```bash
|
|
19
38
|
npm install -g agdi
|
|
20
39
|
```
|
|
21
40
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
### Interactive Mode (Recommended)
|
|
41
|
+
### 2. Run the Wizard
|
|
42
|
+
The easiest way to start is the interactive wizard. It will guide you through authentication and project setup.
|
|
25
43
|
```bash
|
|
26
44
|
agdi
|
|
27
45
|
```
|
|
28
46
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
2. **π API Setup** β Configure Gemini/OpenAI/Anthropic keys
|
|
32
|
-
3. **π§ Prompt** β Describe what you want to build
|
|
33
|
-
|
|
34
|
-
### Direct Mode
|
|
35
|
-
```bash
|
|
36
|
-
agdi "Create a todo app with user authentication"
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### With Options
|
|
47
|
+
### 3. Build a SaaS in Seconds
|
|
48
|
+
Want to go fast? Use the direct build command:
|
|
40
49
|
```bash
|
|
41
|
-
agdi
|
|
50
|
+
agdi build "A project management tool with Kanban boards and team chat"
|
|
42
51
|
```
|
|
43
52
|
|
|
44
53
|
---
|
|
45
54
|
|
|
46
|
-
##
|
|
55
|
+
## π οΈ Features
|
|
56
|
+
|
|
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
|
|
67
|
+
```
|
|
47
68
|
|
|
48
|
-
|
|
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.*
|
|
49
76
|
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
"modelRouting": {
|
|
55
|
-
"planning": "claude-opus-4",
|
|
56
|
-
"coding": "gemini-2.5-pro",
|
|
57
|
-
"chat": "groq/llama-3"
|
|
58
|
-
}
|
|
59
|
-
}
|
|
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
|
|
60
81
|
```
|
|
61
82
|
|
|
62
83
|
---
|
|
63
84
|
|
|
64
|
-
##
|
|
85
|
+
## π€ Supported Models
|
|
65
86
|
|
|
66
|
-
|
|
87
|
+
Agdi supports the absolute bleeding edge of AI models via a unified interface:
|
|
67
88
|
|
|
68
|
-
|
|
|
69
|
-
|
|
70
|
-
| **
|
|
71
|
-
| **
|
|
72
|
-
| **
|
|
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** |
|
|
73
96
|
|
|
74
97
|
---
|
|
75
98
|
|
|
76
|
-
##
|
|
99
|
+
## βοΈ Advanced Usage
|
|
77
100
|
|
|
78
|
-
|
|
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
|
+
```
|
|
79
106
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
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
|
+
```
|
|
84
116
|
|
|
85
117
|
---
|
|
86
118
|
|
|
87
|
-
##
|
|
119
|
+
## π‘οΈ Security
|
|
88
120
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
| `agdi --help` | Show all options |
|
|
94
|
-
| `agdi --version` | Show version |
|
|
121
|
+
Agdi takes security seriously.
|
|
122
|
+
- **Zero-Trust:** It never executes dangerous shell commands without permission (unless `--yes` is used).
|
|
123
|
+
- **Local Keys:** API keys are stored in `~/.agdi/config.json` with `0600` permissions (readable only by you).
|
|
124
|
+
- **Sandboxed:** Code generation happens in your specified directory, never outside it.
|
|
95
125
|
|
|
96
126
|
---
|
|
97
127
|
|
|
98
|
-
##
|
|
128
|
+
## β Troubleshooting
|
|
99
129
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
| `GEMINI_API_KEY` | Google Gemini API key |
|
|
103
|
-
| `OPENAI_API_KEY` | OpenAI API key |
|
|
104
|
-
| `ANTHROPIC_API_KEY` | Anthropic API key |
|
|
105
|
-
| `AGDI_DEBUG` | Enable debug logging |
|
|
130
|
+
**"API Key Invalid"**
|
|
131
|
+
Run `agdi auth` to re-enter your keys. Ensure your plan covers the model you selected.
|
|
106
132
|
|
|
107
|
-
|
|
133
|
+
**"Build Failed"**
|
|
134
|
+
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`.
|
|
108
135
|
|
|
109
|
-
|
|
136
|
+
**"Quota Exceeded"**
|
|
137
|
+
Switch to a cheaper model or provider:
|
|
138
|
+
```bash
|
|
139
|
+
agdi model
|
|
140
|
+
```
|
|
110
141
|
|
|
111
|
-
|
|
142
|
+
---
|
|
143
|
+
|
|
144
|
+
<div align="center">
|
|
145
|
+
<p>Built with β€οΈ by Agdi Systems Inc.</p>
|
|
146
|
+
<p>2026 Edition</p>
|
|
147
|
+
</div>
|