agdi 3.4.3 → 3.4.4
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 -100
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,100 +1,100 @@
|
|
|
1
|
-
# agdi — AI-Powered App Generator
|
|
2
|
-
|
|
3
|
-
Build full-stack web applications from natural language in your terminal.
|
|
4
|
-
|
|
5
|
-
```bash
|
|
6
|
-
npm install -g agdi
|
|
7
|
-
```
|
|
8
|
-
|
|
9
|
-
## Quick Start
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
# 1. Configure your API keys
|
|
13
|
-
agdi auth
|
|
14
|
-
|
|
15
|
-
# 2. Generate a standard app
|
|
16
|
-
agdi build "A kanban board with drag-and-drop"
|
|
17
|
-
|
|
18
|
-
# 3. Generate a production SaaS blueprint (Next.js + Prisma + Stripe)
|
|
19
|
-
agdi build "Task management platform" --saas
|
|
20
|
-
|
|
21
|
-
# 4. Or use the full multi-agent squad
|
|
22
|
-
agdi squad "SaaS dashboard with auth and Stripe billing"
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
## Requirements
|
|
26
|
-
|
|
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/)
|
|
34
|
-
|
|
35
|
-
## Commands
|
|
36
|
-
|
|
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 |
|
|
49
|
-
|
|
50
|
-
## How It Works
|
|
51
|
-
|
|
52
|
-
Agdi uses a **multi-agent architecture** with specialized agents:
|
|
53
|
-
|
|
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)
|
|
59
|
-
|
|
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.
|
|
64
|
-
|
|
65
|
-
## Configuration
|
|
66
|
-
|
|
67
|
-
API keys are stored in `~/.agdi/config.json` (created via `agdi auth`).
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
# Check your setup
|
|
71
|
-
agdi doctor
|
|
72
|
-
|
|
73
|
-
# View current config
|
|
74
|
-
agdi config
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
## Security & Telemetry
|
|
78
|
-
|
|
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).
|
|
84
|
-
|
|
85
|
-
## Common Issues
|
|
86
|
-
|
|
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 |
|
|
92
|
-
|
|
93
|
-
## Links
|
|
94
|
-
|
|
95
|
-
- **Web IDE**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
|
|
96
|
-
- **Discord**: [discord.gg/pPkZ93Yb](https://discord.gg/pPkZ93Yb)
|
|
97
|
-
|
|
98
|
-
## License
|
|
99
|
-
|
|
100
|
-
MIT © Anass Agdi
|
|
1
|
+
# agdi — AI-Powered App Generator
|
|
2
|
+
|
|
3
|
+
Build full-stack web applications from natural language in your terminal.
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
npm install -g agdi
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
## Quick Start
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
# 1. Configure your API keys
|
|
13
|
+
agdi auth
|
|
14
|
+
|
|
15
|
+
# 2. Generate a standard app
|
|
16
|
+
agdi build "A kanban board with drag-and-drop"
|
|
17
|
+
|
|
18
|
+
# 3. Generate a production SaaS blueprint (Next.js + Prisma + Stripe)
|
|
19
|
+
agdi build "Task management platform" --saas
|
|
20
|
+
|
|
21
|
+
# 4. Or use the full multi-agent squad
|
|
22
|
+
agdi squad "SaaS dashboard with auth and Stripe billing"
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Requirements
|
|
26
|
+
|
|
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/)
|
|
34
|
+
|
|
35
|
+
## Commands
|
|
36
|
+
|
|
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 |
|
|
49
|
+
|
|
50
|
+
## How It Works
|
|
51
|
+
|
|
52
|
+
Agdi uses a **multi-agent architecture** with specialized agents:
|
|
53
|
+
|
|
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)
|
|
59
|
+
|
|
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.
|
|
64
|
+
|
|
65
|
+
## Configuration
|
|
66
|
+
|
|
67
|
+
API keys are stored in `~/.agdi/config.json` (created via `agdi auth`).
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# Check your setup
|
|
71
|
+
agdi doctor
|
|
72
|
+
|
|
73
|
+
# View current config
|
|
74
|
+
agdi config
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
## Security & Telemetry
|
|
78
|
+
|
|
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).
|
|
84
|
+
|
|
85
|
+
## Common Issues
|
|
86
|
+
|
|
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 |
|
|
92
|
+
|
|
93
|
+
## Links
|
|
94
|
+
|
|
95
|
+
- **Web IDE**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
|
|
96
|
+
- **Discord**: [discord.gg/pPkZ93Yb](https://discord.gg/pPkZ93Yb)
|
|
97
|
+
|
|
98
|
+
## License
|
|
99
|
+
|
|
100
|
+
MIT © Anass Agdi
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agdi",
|
|
3
|
-
"version": "3.4.
|
|
3
|
+
"version": "3.4.4",
|
|
4
4
|
"description": "The autonomous AI software engineer. Build full-stack web applications from natural language with a multi-agent squad, deep context indexing, and zero-touch deployment.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|