Agent OS transforms AI coding agents from confused interns into productive developers. With structured workflows that capture your standards, your stack, and the unique details of your codebase, Agent OS gives your agents the specs they need to ship quality code on the first try—not the fifth.
Use it with:
✅ Claude Code, Cursor, or any other AI coding tool.
✅ New products or established codebases.
✅ Big features, small fixes, or anything in between.
✅ Any language or framework.
Get Agent OS running in your project in under 5 minutes:
# Install Agent OS base framework (one-time)
curl -sSL https://raw.githubusercontent.com/buildermethods/agent-os/main/scripts/base-install.sh | bash
# Then install in your project
cd your-project
~/agent-os/scripts/project-install.sh --preset claude-code-full# Install from your fork's branch
curl -sSL https://raw.githubusercontent.com/YOUR_USERNAME/agent-os/main/scripts/base-install.sh | bash -s -- --repo YOUR_USERNAME/agent-os --branch YOUR_BRANCH
# Example:
curl -sSL https://raw.githubusercontent.com/johndoe/agent-os/main/scripts/base-install.sh | bash -s -- --repo johndoe/agent-os --branch feature-new-ui# For Claude Code users (recommended)
~/agent-os/scripts/project-install.sh --preset claude-code-full
# For Cursor/Windsurf users
~/agent-os/scripts/project-install.sh --preset cursor
# For beginners or simple projects
~/agent-os/scripts/project-install.sh --preset claude-code-basic📖 Need help choosing? See all presets →
# Plan a new feature
/plan-product
# Write specifications
/shape-spec
# Build the feature
/implement-tasksThat's it! Agent OS is now configured and ready to help you build better code, faster.
Performance boost: Reinstallations are now 30× faster with caching (15s → 0.5s)
Agent OS uses a unique two-phase installation that provides:
- ⚡ 30× faster project setup through intelligent caching
- 🛡️ Transactional safety with automatic rollback on failure
- 🔄 Git-friendly project structures (no .git conflicts)
- 🎯 Zero dependencies (doesn't require git to be installed)
- 📦 Reliable version control (install specific versions reliably)
- Base Installation (
~/agent-os/): Downloads the framework globally once - Project Installation (
./agent-os/): Compiles templates into your project
This design allows for:
- Fast project setup through cached templates
- Project-specific customization without affecting the global installation
- Clean separation between framework and project files
- Ability to commit generated files to your project's git repository
If you're contributing to Agent OS or testing changes on a branch:
# Clone your branch locally
git clone -b your-branch-name https://github.com/YOUR_USERNAME/agent-os.git agent-os-dev
# Install from your local copy
cd agent-os-dev
./scripts/base-install.sh
# Use it in a project
cd ../your-project
~/agent-os/scripts/project-install.shAgent OS provides structured workflows that guide AI agents through the development process:
flowchart LR
A[Product Planning] --> B[Specification]
B --> C[Task Creation]
C --> D[Implementation]
D --> E[Verification]
style A fill:#e1f5fe
style B fill:#f3e5f5
style C fill:#e8f5e9
style D fill:#fff3e0
style E fill:#ffebee
- Plan → Define mission, roadmap, and tech stack
- Specify → Create detailed requirements and technical specs
- Task → Break specs into actionable development tasks
- Implement → Build features following the specifications
- Verify → Test and validate the implementation
Comprehensive docs, guides, & best practices 👉 buildermethods.com/agent-os
Quick links:
Read the changelog
Subscribe to be notified of major new releases of Agent OS
Created by Brian Casel, the creator of Builder Methods, where Brian helps professional software developers and teams build with AI.
Get Brian's free resources on building with AI:
Join Builder Methods Pro for official support and connect with our community of AI-first builders: