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

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

Home / scripts / speckit
Name Modified Size InfoDownloads / Week
Parent folder
T051_verifier_loader_tests.sh 2025-10-03 213 Bytes
T049_template_submission_tests.sh 2025-10-03 213 Bytes
T052_verifier_loader_impl.sh 2025-10-03 212 Bytes
T059_cli_templates_tests.sh 2025-10-03 209 Bytes
T055_api_catalog_tests.sh 2025-10-03 219 Bytes
T057_api_run_tests.sh 2025-10-03 220 Bytes
T060_cli_templates_impl.sh 2025-10-03 209 Bytes
T047_template_tests.sh 2025-10-03 215 Bytes
T054_diagnostics_impl.sh 2025-10-03 225 Bytes
T061_speckit_runner_tests.sh 2025-10-03 222 Bytes
T050_template_submission_impl.sh 2025-10-03 239 Bytes
T055_api_tests.sh 2025-10-03 72 Bytes
T056_api_catalog_impl.sh 2025-10-03 214 Bytes
T048_template_implementation.sh 2025-10-03 214 Bytes
T053_diagnostics_tests.sh 2025-10-03 215 Bytes
T058_api_run_impl.sh 2025-10-03 215 Bytes
T062_speckit_runner_impl.sh 2025-10-03 222 Bytes
Totals: 17 Items   3.5 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