Built MagesticAI, a client-server APP for Spec-Driven Development with AI agents (open source, AGPL-3.0)
I got tired of watching LLMs "vibe-code" with no spec and no way to tell if the result actually matched what I wanted. I´ve wasted so much time reading and answering follow-ups questions, so I invested the last few months flipping the order: spec first, autonomous coding second.
That's MagesticAI: a self-hosted web platform where you describe what you want, the system turns it into a structured spec + technical plan, and then coordinated agents build it in isolated git worktrees.
The flow:
- Define project principles + rules
- Generate the spec (the "what" and the "why")
- Generate the technical plan
- Break into subtasks
- Implement with agents (in isolated worktrees so failures don't trash your repo)
- QA agent validates against the original spec
Stuff I think is interesting:
- Multi-LLM: Claude, Codex (GPT), Gemini, Ollama. Pick per phase.
- Ollama agentic mode with native tool calling (Read, Write, Edit, Bash, Glob, Grep)
works fully offline, no API fallback
- Built-in Kanban board, PTY terminal, Chat and Monaco editor in the browser
- Graphiti-based memory for cross-session context
- Three-track planning (Quick Flow / Standard / Enterprise)
- Docker compose for deployment
Tech stack: Python 3.12 / FastAPI, React 19 / Vite / Tailwind v4, Claude Agent SDK,
Graphiti + LadybugDB.
Honest limitations:
- Only tested on Ubuntu 24.04 + Docker; macOS/WSL2 should work but I haven't verified
- A few endpoint test suites are skipped (the routes exist on the roadmap but aren't
implemented yet, the tests stayed in the repo as a TODO)
- AGPL-3.0 . fine for personal/team use, the SaaS clause makes some companies
cautious.
Credit where due: MagesticAI is a fork of Aperant
(formerly Auto Claude Desktop) by AndyMik90.
I've added the Client-Server(Cloud), multi-LLM provider engine, Ollama native tools, BMad-style complexity-adaptive planning, and a bunch of UX cleanup.
Repo: https://github.com/dataseeek/MagesticAI
Genuinely interested in what people think and especially anyone who's triedagent-driven dev tools and bounced off them. What broke for you? Curious if SDD addresses any of those pain points.