Download Latest Version messages.jsonl (180 Bytes)
Email in envelope

Get an email when there's a new version of orchestrator

Home / tests / server
Name Modified Size InfoDownloads / Week
Parent folder
index.test.ts 2025-10-03 3.9 kB
Totals: 1 Item   3.9 kB 0

Orchestrator

A Node.js orchestration server that bridges VS Code, SpecKit, and LM Studio/Ollama for automated software development workflows.

Project Overview

graph LR
    VS[VS Code Extension] -->|Roadmap/Commands| O[Orchestrator]
    O -->|Template Execution| LM[LM Studio/Ollama]
    O -->|Task Generation| S[SpecKit]
    LM -->|Reasoning| O
    S -->|Automation| O

The orchestrator server enables automated software development by:

  1. Converting roadmap items into SpecKit tasks
  2. Executing templates with LLM-powered reasoning
  3. Automating development tasks through VS Code commands

Prerequisites

  • Node.js 18+
  • LM Studio or Ollama for local LLM execution
  • VS Code with orchestrator extension
  • npm for dependency management

Quick Start

  1. Install dependencies and build:
npm install
npm run build
  1. Start LM Studio (or preferred provider) and orchestrator:
npm run start:orchestrator
  1. Install VS Code extension:
  2. Via packaged .vsix file
  3. Or using vsce package and manual installation

  4. In VS Code:

  5. Generate roadmap.json
  6. Convert to SpecKit tasks
  7. Run templates/automation phases

Development

# Start orchestrator server
npm run start:orchestrator

# Run tests
npm run test:server    # Test orchestrator server
npm run test:extension # Test VS Code extension

See Usage Guide for detailed command reference and troubleshooting.

Environment Variables

Variable Default Description
ORCH_PORT 4100 Orchestrator HTTP port
ORCH_MODEL lmstudio-local Model ID for LLM calls
OPENAI_API_BASE http://localhost:1234/v1 LM Studio API base URL
DESKTOP_DRIVER_URL http://127.0.0.1:39990/computer-use Desktop driver endpoint
MAX_STEPS 8 Maximum steps per task
ORCH_ADMIN_TOKEN (empty) If set, protects /admin/* endpoints
Source: README.md, updated 2025-10-03