Cursor Orchestrator VS Code Extension

A VS Code extension that makes it easy to set up and manage the Cursor Multi-Agent Coding OS from within VS Code.

Features

🚀 Quick Setup - One-click setup for any project
📊 Dashboard - Real-time status monitoring
🔧 Commands - Access all orchestrator commands from VS Code
🎯 Integration - Seamlessly integrates with VS Code workspace

Installation

From VSCode Marketplace

Coming soon! Search for "Cursor Orchestrator" in the Extensions marketplace.

Manual Installation

1. Clone this repository:

   git clone https://github.com/repo/cursor-orchestrator-vscode
   cd cursor-orchestrator-vscode
   

2. Install dependencies:

   npm install
   

3. Build the extension:

   npm run compile
   

4. Open in VS Code:

   code .
   

5. Press F5 to open a new window with the extension loaded

6. (Optional) Package the extension:

   npm install -g vsce
   vsce package
   

Usage

Quick Setup in Current Project

1. Open your project in VS Code
2. Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P)
3. Type "Cursor Orchestrator: Setup"
4. The extension will:
   • Check if orchestrator is installed
   • Verify git repository status
   • Apply orchestrator configuration
   • Update necessary files

Access the Dashboard

• Open the "Orchestrator" panel in the Activity Bar (rocket icon 🚀)
• Or use Command Palette: "Cursor Orchestrator: Open Dashboard"

Available Commands

Using the Orchestrator (in Cursor)

After setup via the extension:

1. Open Cursor (the AI editor, not VS Code)
2. In Chat, type @
3. You should see @orchestrator or @orchestrate_parallel_streams
4. Use it:

   @orchestrator.orchestrate_parallel_streams
   {
     "task": "Implement a feature with tests",
     "repo_path": "/Users/yourname/your-project"
   }
   

Extension Features

Workspace Integration

The extension integrates with your VS Code workspace:

• Automatically detects workspace folder
• Checks git repository status
• Reports uncommitted changes before setup
• Updates .cursor/ configuration in-place

Dashboard

The dashboard provides:

• Real-time status monitoring
• Quick action buttons
• System health checks
• Usage instructions
• Links to documentation

Output Channels

All operations show output in integrated terminal:

• Setup progress
• Test results
• Diagnostic information
• Worktree cleanup

Project Structure

cursor-orchestrator-vscode/
├── src/
│   └── extension.ts          # Main extension logic
├── media/
│   └── dashboard.js          # Dashboard functionality
├── out/                      # Compiled JavaScript (build output)
├── package.json              # Extension manifest
├── tsconfig.json            # TypeScript config
└── README.md                # This file

Development

Prerequisites

• Node.js 18+
• VS Code
• TypeScript
• npm or yarn

Build Commands

# Install dependencies
npm install

# Compile TypeScript
npm run compile

# Watch for changes
npm run watch

# Run tests
npm run test

# Package extension
npm run vsce package

Debugging

1. Open the project in VS Code
2. Press F5 to launch Extension Development Host
3. The extension will load in the new window
4. Use Debug Console to see logs and errors

Configuration

The extension uses these settings (can be customized in settings.json):

{
  "cursor-orchestrator.orchestratorPath": "~/cursor-orchestrator",
  "cursor-orchestrator.setupScript": "~/cursor-orchestrator/scripts/apply-template.sh",
  "cursor-orchestrator.autoCheckStatus": true,
  "cursor-orchestrator.statusRefreshInterval": 30000
}

Troubleshooting

Extension doesn't activate

1. Check VS Code Extensions view
2. Look for "Cursor Orchestrator"
3. If disabled, enable it
4. Reload VS Code window

Setup fails

1. Check orchestrator is installed at ~/cursor-orchestrator/
2. Verify git repository is initialized
3. Commit any uncommitted changes
4. Check Output panel for error messages

Dashboard not loading

1. Reload VS Code window
2. Check for JavaScript errors in Developer Tools (Help → Toggle Developer Tools)
3. Ensure webview is not restricted by security settings

Commands not available

• Make sure a workspace folder is open
• Check that the extension is active
• Try: View → Command Palette, search for "Cursor Orchestrator"

Requirements

• VS Code 1.85.0 or higher
• git 2.20+
• Cursor Orchestrator installed at ~/cursor-orchestrator/
• Python 3.9+

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Write tests if applicable
5. Submit a pull request

License

MIT License - see LICENSE file for details

Support

• Issues: https://github.com/repo/cursor-orchestrator-vscode/issues
• Documentation: https://github.com/repo/cursor-orchestrator
• Cursor Docs: https://docs.cursor.com

Roadmap

• [ ] Publish to VS Code Marketplace
• [ ] Add quick templates (React, Python, Go)
• [ ] Real-time orchestration monitoring
• [ ] Stream status visualization
• [ ] Worktree file explorer
• [ ] Integration test runner
• [ ] Custom project templates
• [ ] Export/Import orchestrator configurations

Changelog

Version 1.0.0 (Current)

• Initial release
• Setup command
• Dashboard webview
• Test and diagnostic commands
• Worktree cleanup
• VS Code workspace integration

Note: This extension helps you SET UP the orchestrator in projects. The actual orchestration runs in Cursor (the AI editor), not in VS Code. The extension bridges the gap between VS Code development and Cursor's multi-agent AI orchestration.