⚡ agdi

The Autonomous AI Software Engineer in your terminal. Build full-stack, production-ready applications from natural language prompts.

agdi doesn't just write boilerplate. It operates as an autonomous squad of AI engineers that plans architecture, writes code, tests it, self-heals errors, and deploys—all without human intervention.

Equipped with Deep Context Indexing, it understands your existing codebase through AST parsing and local semantic vector search before it writes a single line of code.

🚀 Quick Start

Get started in seconds. No complex setup required.

# 1. Install globally
npm install -g agdi

# 2. Configure your API keys (Gemini, Anthropic, OpenAI, etc.)
agdi auth

# 3. Generate a beautiful Kanban board
agdi build "A modern kanban board with drag-and-drop using Tailwind"

# 4. Or use the full autonomous squad for complex SaaS
agdi squad "Task management platform with Stripe billing and Supabase auth"

✨ Why Agdi?

| Capability | Description | |---|---| | 🤖 Multi-Agent Squad | Dedicated Manager, Frontend, Backend, DevOps, and QA agents working in parallel. | | 🧠 Deep Context Engine | Scans your repository, parses TypeScript ASTs, and uses local vector embeddings to understand your architecture. | | 🛠️ SaaS Blueprint | agdi build --saas instantly generates a Next.js App Router project with Prisma, Postgres, Auth, and Stripe. | | 🛡️ Zero-Trust Security | Code Firewall prevents eval() injections and hardcoded secrets. Permission Gate requires your approval for shell executions. | | 🌐 Omnichannel | Control your CLI agent from anywhere via Slack, Discord, or Telegram (agdi channels). | | 📡 Native Gateway | Real-time WebSocket connection for streaming metrics and remote execution control. |

⌨️ Command Reference

A clean, minimal Terminal User Interface (TUI) powers your experience.

| Command | Alias | What it does | |---------|-------|-------------| | agdi | — | Launch the beautiful, interactive TUI dashboard | | agdi build <prompt> | b | Generate or edit an app from a prompt | | agdi build <prompt> --saas | — | Generate a full-stack SaaS blueprint | | agdi squad [prompt] | s | Trigger the multi-agent autonomous builder | | agdi squad --deploy | — | Build and auto-deploy directly to Vercel/Netlify | | agdi squad --breakpoints | — | Pause after each agent task for review | | agdi audit --prod | — | Production readiness scanner (a11y, security, tests) | | agdi sandbox <url> | — | Live API doc reader and endpoint tester | | agdi visual-test | vt | Screenshot regression testing against baselines | | agdi memory | mem | Parse git history for project context & patterns | | agdi deps --full | — | Scan dependencies for vulnerabilities and auto-fix | | agdi plugins | plug | Manage community plugins and IDE extensions | | agdi gateway | gw | Start or check the native WebSocket gateway | | agdi channels | — | Link agdi to your Slack, Discord, or Telegram | | agdi auth | — | Securely configure your BYOK (Bring Your Own Key) access | | agdi doctor | doc | Run environment diagnostics and health checks | | agdi import <url> | i | Clone and auto-scaffold a GitHub repository |

🧠 Supported LLM Providers

Agdi routes tasks to the best model automatically or lets you choose your favorite via Bring-Your-Own-Key (BYOK):

• Google (Gemini 3 Pro, 3 Flash, 2.5 Flash) — Recommended
• Anthropic (Claude 4.5 Sonnet/Opus, 3.5 Sonnet)
• OpenAI (GPT-4.1, GPT-5.2 Codex)
• DeepSeek (DeepSeek V3, R1)
• OpenRouter (Access to 100+ models)
• Meta (Llama 4 Maverick)
• Alibaba (Qwen3 Coder)

Keys are stored securely in ~/.agdi/config.json. We never collect your keys.

🔒 Security & Telemetry

Your code is your code. Agdi runs completely locally (aside from the LLM API calls).

• Code Firewall: Every generated file is scanned for vulnerabilities before writing to disk.
• Audit Logger: All file modifications and shell commands are logged to ~/.agdi/audit.log.
• Telemetry Transparency: Telemetry is opt-in and never contains source code. Run agdi config telemetry --dry-run to see exactly what is sent.

🌐 Web IDE · 💬 Join the Discord · 🐛 Report a Bug

Built with ❤️ for developers.