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.
- Windows PowerShell 5.1 or later (or PowerShell 7+)
- Internet connection for downloading files
Open PowerShell as Administrator and run the following one-liner to install Agent OS:
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup.ps1" -UseBasicParsing).Content
What this does:
- Creates
~/.agent-os/
directory structure in your user profile - Downloads your development standards files
- Downloads Agent OS instruction files
- Sets up the foundation for AI coding agents
Optional flags:
# Overwrite existing instruction files
Invoke-Expression "& { $(Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup.ps1' -UseBasicParsing).Content } -OverwriteInstructions"
# Overwrite existing standards files
Invoke-Expression "& { $(Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup.ps1' -UseBasicParsing).Content } -OverwriteStandards"
%USERPROFILE%\.agent-os\standards\
to match your preferences:
tech-stack.md
- Your default frameworks, libraries, and toolscode-style.md
- Your formatting rules and naming conventionsbest-practices.md
- Your development philosophy and patterns
Choose your AI coding tool:
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup-claude-code.ps1" -UseBasicParsing).Content
Then use these commands in Claude Code:
/plan-product
- Initialize a new product/analyze-product
- Add Agent OS to existing codebase/create-spec
- Plan a new feature/execute-tasks
- Build and ship code
Navigate to your project root directory in PowerShell, then run:
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup-cursor.ps1" -UseBasicParsing).Content
Then use these commands in Cursor:
@plan-product
- Initialize a new product@analyze-product
- Add Agent OS to existing codebase@create-spec
- Plan a new feature@execute-tasks
- Build and ship code
Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup-vscode.ps1" -UseBasicParsing).Content
The script will ask you:
- VS Code version: Choose between VS Code (stable) or VS Code Insiders
- File prefix: Optional prefix for organizing files (e.g., 'g-', 'u-', 'agent-')
This creates prompt and instruction files in your VS Code user directory:
- Commands → Prompts:
plan-product.prompt.md
,create-spec.prompt.md
, etc. - Standards → Instructions:
tech-stack.instructions.md
,code-style.instructions.md
, etc.
Then use these files in VS Code:
- Press
Ctrl+Shift+P
and search for "Prompts" - Select your Agent OS prompts and instructions:
plan-product.prompt.md
- Initialize a new productanalyze-product.prompt.md
- Add Agent OS to existing codebasecreate-spec.prompt.md
- Plan a new featureexecute-tasks.prompt.md
- Build and ship codetech-stack.instructions.md
- Your tech stack standardscode-style.instructions.md
- Your code style standardsbest-practices.instructions.md
- Your development practices
Download and run locally:
# Download the setup script
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/yldgio/agent-os-vscode/main/setup.ps1" -OutFile "setup.ps1"
# Run with parameters
.\setup.ps1 -OverwriteInstructions -OverwriteStandards
For Linux, macOS, and detailed documentation 👉 buildermethods.com/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: