The World's First Self-Improving Agentic Development Framework
Build production-ready applications from ideation to deployment in minutes—not weeks. AgentCodeX orchestrates 23 specialized AI agents that autonomously design, build, test, and deploy your application while continuously learning and improving.
AgentCodeX v3.0 is a complete platform transformation: MCP-native, platform-agnostic, works with ANY AI (OpenAI, Anthropic, Google, Ollama, local), 3-5x faster execution, production-ready with comprehensive CLI.
Status: ✅ MVP Complete (318/318 story points) - Ready for deployment testing!
What's New in v3.0:
./install.sh handles everythingTry v3.0 MVP:
git clone https://github.com/ScaledMinds/AgentCodeX.git
cd AgentCodeX/v3
./install.sh
agentcodex execute "Build a FastAPI todo list API"
📖 v3.0 Documentation | 🚀 Deployment Guide | 🔧 Troubleshooting
Note: v2.x (below) remains stable and production-ready. v3.0 is currently in MVP/alpha testing phase.
AgentCodeX is a revolutionary framework that combines:
🤖 23 Specialized AI Agents - Each expert in their domain (backend, frontend, DevOps, security, market research, UI/UX design, etc.)
🧠 MAESTRO Orchestrator - Supreme autonomous coordinator that manages all agents
🔮 ORACLE Meta-Learner - Self-improvement engine that makes the framework smarter with every project
📦 V4 Tech Stack - Production-ready stack with exact versions (Next.js 15.5, FastAPI 0.118.0, GPT-5, etc.)
⚡ 3-Command CLI - Minimal human interaction, maximum automation
npm install -g agentcodex
1. Create ideation folder with your vision:
mkdir my-saas/ideation
my-saas/ideation/vision.md:
# My SaaS Vision
We're building an AI-powered customer support platform.
## Features
- AI chatbot for common questions
- Ticket management system
- Analytics dashboard
- Team collaboration
## Users
- Support teams at SaaS companies
- Customer success managers
2. Initialize your project:
agentcodex init
# Or with flags for non-interactive:
agentcodex init --name=my-saas --dev=dev.my-saas.com --prod=my-saas.com
3. Edit your PRD and spawn MAESTRO:
cd my-saas
# Edit docs/ideation/prd.md with your requirements
# Then open in Claude Code and run:
/agentcodex-start
"Initialize project from ./ideation/ folder.
Build complete production-ready application.
Ask me for:
- Domain: mysaas.com
- OpenAI API key: [your key]"
4. Watch 23 agents build your app (~45 minutes):
5. Promote to production when ready:
agentcodex promote
Done. Your SaaS is live.
Tier 1: Strategic Intelligence
Tier 2: Core Builders
Tier 3: Integration & Quality
Tier 4: Operations & Intelligence
Backend:
Frontend:
Databases:
Infrastructure:
Observability:
Every AgentCodeX project includes:
✅ Complete Backend API
✅ Modern Frontend
✅ Production Infrastructure
✅ Observability
✅ CI/CD Pipelines
✅ Comprehensive Documentation
AgentCodeX learns from every project it builds.
How it works:
Collect Metrics - After each project, ORACLE gathers:
Analyze Patterns - Identifies:
Apply Improvements - Automatically:
Trigger Upgrades - When 10%+ improvement accumulated:
Example:
Week 1-4: ORACLE observes FORGE failing 15% of time on async routes
Analysis: Prompt lacks async/await examples
Action: Update FORGE prompt with detailed patterns
Result: Failure rate drops to 2% (+13% improvement)
After 10 projects with cumulative 10%+ improvement → AgentCodeX v2.1 released
Coming Soon:
agentcodex initInitialize a new AgentCodeX project.
What it does:
docs/ideation/Usage:
# Interactive mode
agentcodex init
# Non-interactive mode
agentcodex init --name=my-app --dev=dev.myapp.com --prod=myapp.com
agentcodex promotePromote development environment to production.
What it does:
Usage:
agentcodex promote
agentcodex statusShow system and agent status.
What it does:
Usage:
agentcodex status
agentcodex syncSync framework updates to existing projects.
What it does:
Flags:
--check - Check for updates without applying--preview - Show what would change (dry run)--force - Skip confirmation promptsUsage:
# Check for updates
agentcodex sync --check
# Preview changes
agentcodex sync --preview
# Apply updates
agentcodex sync
# Force update (no prompts)
agentcodex sync --force
How it works:
.claude/agents/ are updated automatically.claude/agents-custom/ are never touchedagentcodex restoreRestore from automatic sync backups.
What it does:
Flags:
--latest - Restore most recent backup--force - Skip confirmation promptUsage:
# Interactive restore (select backup)
agentcodex restore
# Restore latest backup
agentcodex restore --latest
# Force restore (no confirmation)
agentcodex restore --latest --force
Note: Backups are created automatically in .agentcodex-backups/ during sync operations. Last 5 backups are kept.
Create ideation/ folder with your ideas:
vision.md - What you're building and whyfeatures.md - What features you wantMAESTRO reviews your ideation and coordinates all agents:
Sequential Phase:
VISIONARY → Creates PRD
ARCHITECT → Designs system
MEMEX → Indexes knowledge
Parallel Building:
FORGE + NEXUS + DATAFORGE + HARBOR
(All build simultaneously)
Parallel Validation:
VALIDATOR + GUARDIAN + SENTINEL
(Test, scan, quality check)
Deployment:
HARBOR → Deploys everything
CHRONICLE → Sets up monitoring
Each agent is an expert:
They work together, sharing context through MEMEX.
45 minutes later:
AgentCodeX takes security seriously:
GUARDIAN agent performs comprehensive security audit on every build.
AgentCodeX builds fast, efficient applications:
Build Metrics:
Runtime Performance:
PROBE agent continuously optimizes for performance.
AgentCodeX welcomes contributions!
git clone https://github.com/ScaledMinds/AgentCodeX
cd agentcodex
npm install
npm link
# Test locally
agentcodex --version
See CONTRIBUTING.md for details.
Complete Documentation Index - Start here for all documentation
v3.0 MVP (October 2025 - COMPLETE! ✅)
./install.shagentcodex doctor commandStatus: Ready for deployment testing and real-world validation!
v3.0 Next Phases:
📋 Phase 3: LLM Provider Expansion (Q1 2026)
📋 Phase 4: Intelligence & Safety (Q1 2026)
📋 Phase 5: Production Polish & Launch (Q2 2026)
v2.4.2 (Current Stable - October 2025)
v2.5 (Planned - if v3.0 adoption is delayed)
MIT License - See LICENSE file for details.
npm install -g agentcodex
agentcodex init
# Edit docs/ideation/prd.md
# Open in Claude Code
# Run: /agentcodex-start
Build production apps in minutes, not months.
🚀 The future of development is agentic. The future is AgentCodeX.
Made with 🤖 by BJ Urban
FAQs
The World's First Self-Improving Agentic Development Framework
We found that agentcodex demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.