Skip to content

TylerRussell/ai-forge

Repository files navigation

AgentStarter

Generate your multi-agent VS Code workspace in minutes.

AgentStarter interviews your team about your stack, workflow, and pain points, then generates a fully personalized VS Code workspace — complete with named agent personas, system prompts, MCP connections, memory scaffolding, drift detection, and safeguards.


Quick Start

export ANTHROPIC_API_KEY=sk-ant-...
npx agentstarter init

That's it. In ~2 minutes you'll have a complete .github/agents/ directory ready to open in VS Code.


What You Get

After running agentstarter init, your project contains:

File/Folder What It Does
.github/agents/*.agent.md Named agent personas with deep system prompts
.vscode/settings.json VS Code chat agent configuration
.vscode/mcp.json MCP server connection stubs (pre-filled for your stack)
.agentstarter/memory/ Per-agent memory files for cross-session learning
.agentstarter/agentstarter.config.json Full workspace configuration
README.md Workspace documentation for your team

How It Works

1. Interview. AgentStarter asks 6 quick questions: your team name, tech stack, workflow pain points, safeguards, MCP connections, and preferred theme. The whole interview takes about 90 seconds.

2. Generation. Your answers are combined with deep stack-specific knowledge (Packs) and sent to Claude. Each agent is generated with a unique persona, clear role boundaries, collaboration instructions, and stack-specific expertise.

3. Workspace. All files are written to your project. Open in VS Code, open the Chat panel (⌘I), and select an agent from the dropdown. You're ready to go.


Themes

Every theme gives your agents memorable names and personalities:

Theme Orchestrator Developer Reviewer Documenter
⚔️ Fantasy Archmage 🧙 Blacksmith ⚒️ Inquisitor 🔍 Scribe 📜
🚀 Space Commander 👨‍✈️ Engineer 🔧 Auditor 📡 Chronicler 📓
🏆 Sports Coach 📋 Playmaker ⚡ Referee 🟨 Commentator 🎙️
🎮 Video Games Guild Master 👑 Builder 🧱 Critic 🎯 Lorekeeper 📖
⚡ Mythology Zeus ⚡ Hephaestus 🔨 Themis ⚖️ Hermes 📜
🌿 Nature Shepherd 🐑 Beaver 🦫 Hawk 🦅 Owl 🦉
✏️ Custom You name them

Agent Roles

Role What It Does
Orchestrator Coordinates tasks between agents, manages workflow
Developer Writes, edits, and refactors code
Reviewer Reviews PRs, code quality, and architecture decisions
Documenter Writes docs, notes, ADRs, and changelogs
Architect System design, tech decisions, pattern analysis
Discovery Codebase exploration, dependency analysis, unknowns
Data Queries, dashboards, data pipelines, ML integration
Security Vulnerability scanning, auth review, compliance
DevOps CI/CD, infra, deployments, monitoring
QA Test generation, coverage analysis, regression hunting

Packs

Packs inject deep, stack-specific knowledge into your agents — idiomatic patterns, common footguns, testing strategies, architecture opinions, and debugging playbooks.

Category Packs
Frontend ⚛️ React · 🅰️ Angular · 💚 Vue · 🟠 Svelte · ▲ Next.js · 🔺 Nuxt
Backend ☕ Kotlin · ☕ Java · 🐍 Python · 🦫 Go · 🦀 Rust · 💎 Ruby · 🟢 Node.js · 🐘 PHP · 🔷 C#/.NET · 🍃 Spring Boot
Data 🐘 PostgreSQL · 🍃 MongoDB · 🧊 Redis · 🔍 Elasticsearch · 📡 Kafka · ❄️ Snowflake · 🧱 Databricks/Spark
Infra 🐳 Docker · ☸️ Kubernetes · 🏗️ Terraform · ⚡ Serverless
Cross-Cutting 🔭 OpenTelemetry · 🔐 OAuth2/OIDC · 🧪 Testing · 🧱 GraphQL · 🔄 CI/CD · 🔷 TypeScript

Unlock all 33 packs → $19 at https://aiforgedev.lemonsqueezy.com/buy/1062202

agentstarter activate <your-license-key>

MCP Support

AgentStarter pre-selects and wires up MCP servers based on your stack. 50+ MCPs available including:

GitHub, Jira, Confluence, Linear, Slack, Notion, PostgreSQL, MongoDB, Redis, Snowflake, BigQuery, Kafka, Elasticsearch, AWS, GCP, Azure, Docker, Kubernetes, Terraform, Stripe, Sentry, Datadog, Grafana, and more.

MCP credentials go in .vscode/mcp.json — the structure is generated, you fill in your keys.


Commands

agentstarter init              Run the interview and generate your workspace
agentstarter activate <key>    Activate a Pro license key
agentstarter deactivate        Remove your stored license
agentstarter status            Show version, license, and pack info
agentstarter packs             List all packs with lock/unlock status
agentstarter help              Show usage

Requirements

  • Node.js 18+
  • Anthropic API key — set ANTHROPIC_API_KEY in your environment
    • Get one at console.anthropic.com
    • Generation costs approximately $0.02-0.10 per workspace (depending on agent count)

Supply Chain Security

AgentStarter is published to npm via GitHub Actions with npm provenance attestation. Every release is cryptographically linked to its source commit on GitHub. You can verify a release's provenance with:

npm audit signatures agentstarter

License

MIT. See LICENSE.


Generated workspaces belong to you. Your API key never leaves your machine except in the direct Anthropic API call. See SECURITY.md for the full privacy breakdown.

About

Forge your multi-agent VS Code workspace in minutes

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors