​
Overview

Orchestration is a powerful feature of the SynapseX VS Code Agent that enables you to run multiple sub-agents simultaneously. This allows for parallel processing of different parts of a larger feature or bug fix, significantly speeding up development workflows. By leveraging the SynapseX CLI, sub-agents operate in their own terminal instances, each handling specific tasks while the SynapseX VS Code Agent coordinates the overall process.

​
How It Works

The Orchestration feature utilizes the SynapseX CLI to spawn multiple sub-agents, each running in a dedicated terminal. The SynapseX VS Code Agent:
  1. Analyzes the overall task and breaks it down into sub-tasks. Users can also specify how they wish for the tasks to be separated.
  2. Provides each sub-agent with the necessary context, instructions, and resources.
  3. Monitors progress and consolidates results from all sub-agents.
  4. Ensures seamless integration of changes across the project.
This approach allows for concurrent execution of tasks that would otherwise be sequential, reducing development time for complex features.
Orchestration requires SynapseX CLI to be installed and configured on your system. Refer to the SynapseX CLI Getting Started guide for detailed installation instructions.

​
Getting Started

To use Orchestration in your VS Code Agent:
  1. Ensure you have the SynapseX VS Code extension installed and configured (see Getting Started)
  2. Verify that SynapseX CLI is set up on your system (see SynapseX CLI)
  3. When planning to use the orchestration feature, specify that you’d like to use multiple subagents to speed up the task:
> use multiple agents to implement the user dashboard — split between frontend components and API endpoints
  1. The agent will automatically break down the task and spawn sub-agents as needed.
  2. Each sub-agent will execute in its own terminal tab within VS Code.

​
Using /multi-agent Command

You can explicitly trigger orchestration with the /multi-agent command: 
/multi-agent build a full e-commerce checkout flow with React frontend and Node.js API
/multi-agent refactor the entire authentication system for security improvements
/multi-agent add comprehensive test coverage to the entire project
The SynapseX VS Code extension will create each subagent and manage their tasks.

​
Benefits

BenefitDescription
Parallel ProcessingWork on multiple components simultaneously, cutting overall development time
Efficient Resource UseOptimize time and effort on critical tasks by distributing workload
Testing Multiple ApproachesExperiment with different implementations without sequential bottlenecks
ScalabilityHandle large-scale changes across multiple files, modules, or services
Cost-EffectiveSave money by reducing time spent on manual coordination and testing

​
Use Cases

​
Large Feature Implementation

When developing a comprehensive platform update involving frontend UI changes, backend API modifications, and database schema updates, Orchestration allows sub-agents to handle each component in parallel:
  • Sub-agent 1: Updates React components for the new checkout flow
  • Sub-agent 2: Modifies FastAPI endpoints for payment processing
  • Sub-agent 3: Updates database schemas and migration scripts
The SynapseX VS Code Agent then integrates all changes and runs comprehensive tests.

​
Bug Fix Optimization

For a complex authentication bug affecting multiple services, Orchestration enables testing multiple fix strategies simultaneously:
  • Sub-agent A: Implements a token refresh mechanism
  • Sub-agent B: Updates session management logic
  • Sub-agent C: Modifies error handling in API responses
The SynapseX VS Code Agent evaluates the results and selects the most effective solution.

​
Refactoring Large Codebases

When modernizing a legacy application with thousands of lines of code, Orchestration can parallelize refactoring tasks:
  • Sub-agent 1: Converts class-based components to functional components in React
  • Sub-agent 2: Updates API calls to use modern async/await patterns
  • Sub-agent 3: Implements new TypeScript interfaces and types
This ensures consistent refactoring across the entire codebase in a fraction of the time.

​
Quantum Circuit Development

SynapseX supports quantum-specific orchestration patterns:
  • Sub-agent 1: Implements quantum circuit using QCOS SDK
  • Sub-agent 2: Writes classical post-processing and analysis
  • Sub-agent 3: Sets up benchmarking and validation tests

Key Features

All VS Code Agent capabilities

Best Practices

Maximize your workflow efficiency

SynapseX CLI

CLI required for orchestration

Orchestrators

Server-side agent orchestration