Agdi CLI — The Autonomous AI Employee

---

⚡ What is Agdi?

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:

- 🧠 The Manager: Plans the architecture, breaks down tasks, and oversees the project.
- 🎨 The Designer: Builds beautiful, responsive UI components (React + Tailwind + Shadcn).
- ⚙️ The Engineer: Implements secure APIs, database schemas, and backend logic.
- 🕵️ The QA: Runs builds, writes tests, detects errors, and auto-fixes them before you ever see the code.
- 🚀 The DevOps: Handles deployment to Vercel/Netlify automatically.

---

🚀 Getting Started

$3

``bash
npm install -g agdi
`

$3

The easiest way to start is the interactive wizard. It will guide you through authentication and project setup.
`bash
agdi
`

$3

Want to go fast? Use the direct build command:
`bash
agdi build "A project management tool with Kanban boards and team chat"
`

---

🛠️ Features

$3

Generate a production-ready SaaS foundation instantly:
- Framework: Next.js 15 (App Router)
- Database: Prisma + PostgreSQL
- Auth: Clerk / NextAuth
- Payments: Stripe Subscription integration
- Styling: Tailwind CSS + Shadcn UI

`bash
agdi build "AI-powered CRM for real estate agents" --saas
`

$3

Agdi's QA agent runs in a loop. If the build fails:
1. It analyzes the error logs.
2. It reads the source code.
3. It generates a surgical fix.
4. It re-runs the build.
You get working code, not error messages.

$3

Have an existing repo? Import it and ask Agdi to add features.
`bash
agdi import https://github.com/user/repo
`

---

🤖 Supported Models

Agdi supports the absolute bleeding edge of AI models via a unified interface:

| Provider | Models Supported | Best For |
|----------|------------------|----------|
| Google | Gemini 3 Pro, 2.5 Flash | Speed & Context (Recommended) |
| OpenAI | GPT-5, GPT-4o, o1 | Complex Logic |
| Anthropic | Claude 3.5 Sonnet, Opus | Coding & Architecture |
| DeepSeek | DeepSeek V3, R1 | Reasoning & Cost Efficiency |
| OpenRouter| 100+ Models | Flexibility |

---

⚙️ Advanced Usage

$3

For complex projects, invoke the full squad explicitly:
`bash
agdi squad "Crypto portfolio tracker with real-time websocket updates"
`

$3

View or edit your API keys and settings:
`bash
agdi config
`
Enable telemetry to help us debug crashes (fully anonymous):
`bash
agdi config telemetry --enable
`

---

🛡️ Security

Agdi takes security seriously.
- Zero-Trust: It never executes dangerous shell commands without permission (unless --yes is used).
- Local Keys: API keys are stored in ~/.agdi/config.json with 0600 permissions (readable only by you).
- Sandboxed: Code generation happens in your specified directory, never outside it.

---

❓ Troubleshooting

"API Key Invalid"
Run agdi auth to re-enter your keys. Ensure your plan covers the model you selected.

"Build Failed"
If the auto-healer gives up, check the logs in runs//report.md. You can often fix the small typo manually and run npm run dev.

"Quota Exceeded"
Switch to a cheaper model or provider:
`bash
agdi model
``

---

Built with ❤️ by Agdi Systems Inc.

2026 Edition