agentstarter
v0.3.0
Published
Generate your multi-agent VS Code workspace in minutes
Maintainers
Readme
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 initThat'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 usageRequirements
- Node.js 18+
- Anthropic API key — set
ANTHROPIC_API_KEYin 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 agentstarterLicense
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.
