AgentX

The autonomous AI agent that builds production-ready websites from your terminal.

⚡ What is AgentX?

AgentX is a terminal-based autonomous AI agent designed from the ground up to plan, code, test, and ship complete, production-grade web applications in minutes.

Unlike standard code-completion assistants, AgentX operates like a senior full-stack developer:

1. Plans Before Acting: Writes an explicit multi-step blueprint and verifies requirements before touching code.
2. Reads Before Editing: Analyzes your workspace structure, dependencies, and syntax trees before modifying files.
3. Uses Real Tools: Executes shell commands, resolves dependencies, and applies unified diffs in real-time.
4. Iterates Until Green: Automatically detects and fixes TypeScript errors, lint warnings, and build failures until the project compiles cleanly.
5. Ships Live: Generates deployment configurations for Vercel, Netlify, Railway, or Fly.io and initializes git tracking.

🚀 Quick Start

📦 npm (Recommended)

npm install -g @agent-qofeno/agentx-cli
agentx

🍺 Homebrew (macOS & Linux)

brew tap SohailKhan0525/agentx
brew install agentx

🦕 JSR

npx jsr add @agent-qofeno/agentx-cli

📦 GitHub Packages

npm install -g @SohailKhan0525/agentx-cli --registry https://npm.pkg.github.com

🧠 Supported AI Providers

AgentX connects seamlessly to cloud AI models and private offline models:

| Provider | Models Supported | Token Setup | |---|---|---| | Anthropic Claude | claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5 | console.anthropic.com | | ChatGPT (OpenAI) | gpt-4o, gpt-4o-mini, gpt-4-turbo, o1 | platform.openai.com | | Google Gemini | gemini-2.0-flash, gemini-1.5-pro, gemini-1.5-flash | aistudio.google.com | | GitHub Copilot | Copilot Enterprise & Individual Chat models | GitHub Personal Access Token | | Local Models | Ollama, LM Studio, Jan, GPT4All, llama.cpp | 100% Free & Offline |

🔒 Security Notice: All API keys are stored in your operating system's native secure credential vault (Keychain on macOS, Windows Credential Manager on Windows, Secret Service on Linux) via keytar. Keys are never written to plain text or committed to git.

🛠️ Supported Frameworks & Tech Stacks

AgentX intelligently configures the optimal stack based on your product requirements:

• Next.js 14 (App Router): Server components, SSR, SSG, API routes, Tailwind CSS.
• React + Vite: Ultra-fast Single Page Applications, internal dashboards, and developer tools.
• Astro: Content-driven websites, docs, and high-performance blogs with island architecture.
• Nuxt 3: Modern Vue 3 full-stack applications with universal rendering.
• Full TypeScript: Every project is generated with strict TypeScript definitions and zero lint errors.

🔌 Integrated Backend & Cloud Services

AgentX automatically scaffolds SDK clients, environment variables, and authentication flows for:

• Authentication: Clerk, Supabase Auth, Firebase Auth, NextAuth / Auth.js.
• Databases: Supabase, Firebase Firestore, Appwrite, MongoDB Atlas, PlanetScale, PostgreSQL.
• Payments: Stripe Checkout, Customer Portal, Webhooks, Lemon Squeezy.
• Email: Resend, SendGrid, Postmark, Mailgun.
• File Storage: Cloudflare R2, AWS S3, Uploadthing, Supabase Storage.
• Hosting & Deployment: Vercel, Netlify, Railway, Fly.io, Cloudflare Pages, Render.

⌨️ Slash Commands & Shortcuts

Inside the interactive terminal session, control your agent with slash commands:

| Command | Description | |---|---| | /help | Display all available commands and keyboard shortcuts | | /model | Switch between AI models on the fly | | /provider | Connect or switch between AI providers | | /cost | Show session token metrics and estimated inference cost | | /theme | Toggle terminal UI themes | | /clear | Clear screen and session message history | | /exit | Safely exit AgentX |

💻 Multi-Platform Support

AgentX is engineered and continuously tested across:

• Windows: Windows 10/11 (PowerShell, Windows Terminal, Command Prompt).
• macOS: Apple Silicon (M1/M2/M3/M4) & Intel (x86_64).
• Linux: Ubuntu, Debian, Fedora, Arch Linux, Alpine.

📖 Documentation

Full documentation, configuration guides, and architecture references are available at: 👉 https://sohailkhan0525.github.io/agentx-docs/ (or https://agentx.js.org)

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide and join our community on GitHub Issues.

📄 License

AgentX is open-source software licensed under the MIT License.