agdi 3.4.2 → 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.
Files changed (2) hide show
  1. package/README.md +100 -92
  2. package/package.json +15 -3
package/README.md CHANGED
@@ -1,92 +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 an app
16
- agdi build "A kanban board with drag-and-drop"
17
-
18
- # 3. Or use the full multi-agent squad
19
- agdi squad "SaaS dashboard with auth and Stripe billing"
20
- ```
21
-
22
- ## Requirements
23
-
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/)
31
-
32
- ## Commands
33
-
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 |
46
-
47
- ## How It Works
48
-
49
- Agdi uses a **multi-agent architecture** with specialized agents:
50
-
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)
56
-
57
- The CLI also indexes your existing codebase using **AST parsing** and **vector embeddings** for deep context understanding.
58
-
59
- ## Configuration
60
-
61
- API keys are stored in `~/.agdi/config.json` (created via `agdi auth`).
62
-
63
- ```bash
64
- # Check your setup
65
- agdi doctor
66
-
67
- # View current config
68
- agdi config
69
- ```
70
-
71
- ## Security
72
-
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`
76
-
77
- ## Common Issues
78
-
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 |
84
-
85
- ## Links
86
-
87
- - **Web IDE**: [agdi-dev.vercel.app](https://agdi-dev.vercel.app)
88
- - **Discord**: [discord.gg/pPkZ93Yb](https://discord.gg/pPkZ93Yb)
89
-
90
- ## License
91
-
92
- 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,7 +1,7 @@
1
1
  {
2
2
  "name": "agdi",
3
- "version": "3.4.2",
4
- "description": "AI-powered app generator - build full-stack apps from natural language in your terminal",
3
+ "version": "3.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": {
7
7
  "agdi": "bin/agdi.js"
@@ -28,19 +28,31 @@
28
28
  "keywords": [
29
29
  "cli",
30
30
  "ai",
31
+ "agent",
32
+ "autonomous",
31
33
  "code-generation",
32
34
  "app-generator",
33
35
  "llm",
34
36
  "gpt",
35
37
  "claude",
36
38
  "gemini",
39
+ "deepseek",
37
40
  "react",
41
+ "nextjs",
38
42
  "vite",
39
43
  "full-stack"
40
44
  ],
41
- "author": "Agdi Systems Inc.",
45
+ "author": "Anass Agdi <anassagd432@gmail.com>",
42
46
  "license": "MIT",
43
47
  "homepage": "https://agdi-dev.vercel.app",
48
+ "repository": {
49
+ "type": "git",
50
+ "url": "https://github.com/anassagd432/Agdi-dev.git",
51
+ "directory": "packages/cli"
52
+ },
53
+ "bugs": {
54
+ "url": "https://github.com/anassagd432/Agdi-dev/issues"
55
+ },
44
56
  "engines": {
45
57
  "node": ">=20.0.0"
46
58
  },