mrsimpson · Dec 6, 2025 · Nov 24, 2025 · Nov 25, 2025 · Nov 25, 2025 · Nov 25, 2025
diff --git a/.github/agents/Vibe.agent.md b/.github/agents/Vibe.agent.md
@@ -0,0 +1,31 @@
+---
+description: AI assistant that helps users develop software features using the responsible-vibe-mcp server.'
+tools:
+  [
+    'edit',
+    'runNotebooks',
+    'search',
+    'new',
+    'runCommands',
+    'runTasks',
+    'responsible-vibe-mcp/*',
+    'usages',
+    'vscodeAPI',
+    'problems',
+    'changes',
+    'testFailure',
+    'openSimpleBrowser',
+    'fetch',
+    'githubRepo',
+    'extensions',
+    'runSubagent',
+  ]
+---
+
+You are an AI assistant that helps users develop software features using the responsible-vibe-mcp server.
+
+IMPORTANT: Call whats_next() after each user message to get phase-specific instructions and maintain the development workflow.
+
+Each tool call returns a JSON response with an "instructions" field. Follow these instructions immediately after you receive them.
+
+Do not use your own task management tools. Use the development plan which you will retrieve via whats_next() for all task tracking and project management.
diff --git a/.vibe/development-plan-vscode_skript.md b/.vibe/development-plan-vscode_skript.md
@@ -0,0 +1,101 @@
+# Development Plan: responsible-vibe-mcp (vscode_skript branch)
+
+*Generated on 2025-11-24 by Vibe Feature MCP*
+*Workflow: [minor](https://mrsimpson.github.io/responsible-vibe-mcp/workflows/minor)*
+
+## Goal
+Neuer VS Code Config Generator für das `--generate-config vscode` Kommando erstellen.
+
+## Explore
+### Tasks
+*Alle Tasks abgeschlossen*
+
+### Completed
+- [x] Created development plan file
+- [x] Analysiere bestehende Config-Generatoren (Amazon Q, Claude, Gemini, OpenCode)
+- [x] Bestimme VS Code Konfigurationsformat und benötigte Dateien
+- [x] Entwerfe VS Code Generator-Implementierung
+
+## Implement
+
+### Phase Entrance Criteria:
+- [x] VS Code Konfigurationsformat ist klar definiert
+- [x] Benötigte Dateien und deren Struktur sind dokumentiert
+- [x] Generator-Design ist im Plan-File dokumentiert
+
+### Tasks
+*Alle Tasks abgeschlossen*
+
+### Completed
+- [x] Implementiere VSCodeConfigGenerator Klasse in config-generator.ts
+- [x] Registriere VSCodeConfigGenerator in ConfigGeneratorFactory
+- [x] Aktualisiere Dokumentation (README.md, agent-setup.md)
+- [x] Fixe async/await für parseCliArgs und runCli
+- [x] Teste Config-Generierung mit `--generate-config vscode`
+- [x] Verifiziere generierte Dateien (.vscode/mcp.json und .github/copilot-instructions.md)
+
+## Finalize
+
+### Phase Entrance Criteria:
+- [x] VS Code Config Generator ist implementiert
+- [x] Generator ist in Factory registriert
+- [x] Funktionalität ist getestet
+
+### Tasks
+*Alle Tasks abgeschlossen*
+
+### Completed
+- [x] Code Cleanup: Debug-Output geprüft (alle console.log sind legitime CLI-Outputs)
+- [x] Dokumentation finalisiert (README.md, packages/docs/README.md, agent-setup.md)
+- [x] Test-Verzeichnis aufgeräumt (test-vscode-config und test-generation.sh entfernt)
+- [x] Tests laufen erfolgreich
+
+## Key Decisions
+
+### VS Code + GitHub Copilot Konfiguration
+- **Unterschied zu Claude**: VS Code nutzt `.vscode/mcp.json` statt root `.mcp.json`
+- **System Prompt**: GitHub Copilot nutzt `.github/copilot-instructions.md` statt separate CLAUDE.md
+- **Zwei Dateien generieren**:
+  1. `.vscode/mcp.json` - MCP Server Konfiguration
+  2. `.github/copilot-instructions.md` - System Instructions für Copilot
+- **Tool-Referenzierung**: In Instructions mit `#responsible-vibe-mcp_tool_name` Syntax
+- **Windows-Kompatibilität**: Wie andere Generatoren - cmd/npx basierend auf Plattform
+
+### Bestehende Generator-Architektur
+- Factory Pattern mit ConfigGenerator Basisklasse
+- Jeder Generator erbt von ConfigGenerator
+- Shared utilities: getSystemPrompt(), writeFile(), getDefaultMcpConfig()
+- Factory registriert Generatoren im switch statement
+
+### VS Code Generator Design
+```typescript
+class VSCodeConfigGenerator extends ConfigGenerator {
+  async generate(outputDir: string): Promise<void> {
+    // 1. Generate .vscode/mcp.json with server config
+    // 2. Generate .github/copilot-instructions.md with system prompt + tool guidance
+  }
+}
+```
+
+## Notes
+
+### VS Code MCP Konfigurationsformat
+```json
+{
+  "servers": {
+    "responsible-vibe-mcp": {
+      "command": "npx",
+      "args": ["@codemcp/workflows@latest"]
+    }
+  }
+}
+```
+
+### Copilot Instructions Format
+- Markdown-Format
+- Beschreibt verfügbare MCP Tools
+- Gibt Anweisungen für Workflow-Nutzung
+- Tool-Referenzen: `#responsible-vibe-mcp_whats_next`, etc.
+
+---
+*This plan is maintained by the LLM. Tool responses provide guidance on which section to focus on and what tasks to work on.*
diff --git a/.vscode/mcp.json b/.vscode/mcp.json
@@ -0,0 +1,10 @@
+{
+  "servers": {
+    "responsible-vibe-mcp": {
+      "command": "npx",
+      "args": [
+        "@codemcp/workflows@latest"
+      ]
+    }
+  }
+}
diff --git a/README.md b/README.md
@@ -10,7 +10,7 @@ Transform any AI coding agent into a structured development partner with battle-
 
 ```bash
 # Setup your coding agent
-npx responsible-vibe-mcp --generate-config amazonq-cli  # or claude, gemini, opencode
+npx responsible-vibe-mcp --generate-config amazonq-cli  # or claude, gemini, opencode, copilot-vscode
 # OR manually configure any MCP agent with our system prompt, check the docs for that
 ```
 

diff --git a/packages/cli/src/cli.ts b/packages/cli/src/cli.ts
@@ -121,7 +121,9 @@ function parseCliArgs(): { shouldExit: boolean } {
     if (!agent) {
       console.error('❌ Error: --generate-config requires an agent parameter');
       console.error('Usage: --generate-config <agent>');
-      console.error('Supported agents: amazonq-cli, claude, gemini, opencode');
+      console.error(
+        'Supported agents: amazonq-cli, claude, gemini, opencode, copilot-vscode'
+      );
       process.exit(1);
     }
     handleGenerateConfig(agent);

diff --git a/packages/cli/src/config-generator.ts b/packages/cli/src/config-generator.ts
@@ -374,6 +374,42 @@ class OpencodeConfigGenerator extends ConfigGenerator {
   }
 }
 
+/**
+ * VS Code Configuration Generator
+ * Generates .vscode/mcp.json and .github/agents/Vibe.agent.md for GitHub Copilot Vibe mode
+ */
+class VSCodeConfigGenerator extends ConfigGenerator {
+  async generate(outputDir: string): Promise<void> {
+    const systemPrompt = this.getSystemPrompt();
+    const mcpServers = this.getDefaultMcpConfig();
+
+    // Generate .vscode/mcp.json (MCP server configuration for VS Code)
+    const vscodeDir = join(outputDir, '.vscode');
+    await mkdir(vscodeDir, { recursive: true });
+
+    const mcpConfig = {
+      servers: mcpServers,
+    };
+    const mcpJsonPath = join(vscodeDir, 'mcp.json');
+    await this.writeFile(mcpJsonPath, JSON.stringify(mcpConfig, null, 2));
+
+    // Generate .github/agents/Vibe.agent.md (Agent configuration for GitHub Copilot Vibe mode)
+    const githubAgentsDir = join(outputDir, '.github', 'agents');
+    await mkdir(githubAgentsDir, { recursive: true });
+
+    const agentContent = `---
+description: AI assistant that helps users develop software features using the responsible-vibe-mcp server.
+tools: ['edit', 'runNotebooks', 'search', 'new', 'runCommands', 'runTasks', 'responsible-vibe-mcp/*', 'usages', 'vscodeAPI', 'problems', 'changes', 'testFailure', 'openSimpleBrowser', 'fetch', 'githubRepo', 'extensions', 'runSubagent']
+---
+
+${systemPrompt}
+`;
+
+    const agentPath = join(githubAgentsDir, 'Vibe.agent.md');
+    await this.writeFile(agentPath, agentContent);
+  }
+}
+
 /**
  * Factory class for creating configuration generators
  */
@@ -388,9 +424,12 @@ class ConfigGeneratorFactory {
         return new GeminiConfigGenerator();
       case 'opencode':
         return new OpencodeConfigGenerator();
+      case 'vscode':
+      case 'copilot-vscode':
+        return new VSCodeConfigGenerator();
       default:
         throw new Error(
-          `Unsupported agent: ${agent}. Supported agents: amazonq-cli, claude, gemini, opencode`
+          `Unsupported agent: ${agent}. Supported agents: amazonq-cli, claude, gemini, opencode, vscode`
         );
     }
   }

diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts
@@ -28,5 +28,5 @@ if (args.length === 0) {
 } else {
   // Any arguments, run CLI
   const { runCli } = await import('./cli.js');
-  runCli();
+  await runCli();
 }
diff --git a/packages/cli/test/cli.test.ts b/packages/cli/test/cli.test.ts
@@ -191,7 +191,7 @@ describe('CLI', () => {
         '❌ Error: --generate-config requires an agent parameter'
       );
       expect(consoleErrorSpy).toHaveBeenCalledWith(
-        'Supported agents: amazonq-cli, claude, gemini, opencode'
+        'Supported agents: amazonq-cli, claude, gemini, opencode, copilot-vscode'
       );
     });
   });

diff --git a/packages/cli/test/config-generator.test.ts b/packages/cli/test/config-generator.test.ts
@@ -102,6 +102,36 @@ describe('Config Generator', () => {
     });
   });
 
+  describe('VS Code Configuration', () => {
+    it('should generate VS Code configuration files', async () => {
+      await generateConfig('vscode', tempDir);
+
+      // Check .vscode/mcp.json
+      const mcpJsonPath = join(tempDir, '.vscode', 'mcp.json');
+      expect(existsSync(mcpJsonPath)).toBe(true);
+      const mcpConfig = JSON.parse(readFileSync(mcpJsonPath, 'utf-8'));
+      expect(mcpConfig.servers['responsible-vibe-mcp']).toBeDefined();
+
+      // Check .github/agents/Vibe.agent.md
+      const agentPath = join(tempDir, '.github', 'agents', 'Vibe.agent.md');
+      expect(existsSync(agentPath)).toBe(true);
+      const agentContent = readFileSync(agentPath, 'utf-8');
+
+      // Check YAML frontmatter
+      expect(agentContent).toContain('---');
+      expect(agentContent).toContain(
+        'description: AI assistant that helps users develop software features using the responsible-vibe-mcp server.'
+      );
+      expect(agentContent).toContain(
+        "tools: ['edit', 'runNotebooks', 'search', 'new', 'runCommands', 'runTasks', 'responsible-vibe-mcp/*'"
+      );
+
+      // Check system prompt content
+      expect(agentContent).toContain('responsible-vibe-mcp');
+      expect(agentContent).toContain('whats_next()');
+    });
+  });
+
   describe('Error Handling', () => {
     it('should throw error for unsupported agent', async () => {
       await expect(generateConfig('unsupported', tempDir)).rejects.toThrow(

diff --git a/packages/docs/README.md b/packages/docs/README.md
@@ -77,7 +77,7 @@ Works with any agent that supports the Model Context Protocol. Amazon Q CLI, Cla
 
 ```bash
 # Setup your coding agent (works with any MCP-compatible agent)
-npx responsible-vibe-mcp --generate-config amazonq-cli  # or claude, gemini, opencode
+npx responsible-vibe-mcp --generate-config amazonq-cli  # or claude, gemini, opencode, copilot-vscode
 ```
 
 Head to an empty directory and try: _"Build a simple todo app with a terminal interface"_

diff --git a/packages/docs/user/agent-setup.md b/packages/docs/user/agent-setup.md
@@ -48,6 +48,14 @@ npx responsible-vibe-mcp --generate-config opencode
 
 _Limitation: Until [`#1961`](https://github.com/sst/opencode/issues/1961) is resolved, permissions to ask the user before executing proceed_to_phase will not be respected. Thus, RV MCP in OpenCode is currently a bit ... stressful_
 
+### VS Code (GitHub Copilot)
+
+```bash
+npx responsible-vibe-mcp --generate-config copilot-vscode
+```
+
+**Creates**: `.vscode/mcp.json`, `.github/agents/Vibe.agent.md`
+
 ## Manual Setup
 
 If you prefer manual configuration or use a different agent:
@@ -198,6 +206,13 @@ npx responsible-vibe-mcp --generate-config opencode
 2. System prompt is automatically provided via MCP
 3. Tool permissions are configured to prevent automatic phase transitions
 
+### VS Code (GitHub Copilot)
+
+**Manual Setup**:
+
+1. Create `.vscode/mcp.json` with MCP server configuration
+2. Either create `.github/copilot-instructions.md` or an agent definition `.github/agents/Vibe.agent.md` with the system-prompt
+
 ## Custom Project Path
 
 To use a different project directory, set the `PROJECT_PATH` environment variable: