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

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

Home / scripts
Name Modified Size InfoDownloads / Week
Parent folder
speckit 2025-10-03
bootstrap_linux_orchestrator_and_install_claude.sh 2025-10-03 3.2 kB
post-explorer-diagnosis.ps1 2025-10-03 2.1 kB
post-task.ps1 2025-10-03 1.6 kB
post_linux_orchestrator_task_install_claude.sh 2025-10-03 3.7 kB
quick-test.ps1 2025-10-03 719 Bytes
convert-roadmap.mts 2025-10-03 385 Bytes
convert-roadmap.ts 2025-10-03 432 Bytes
post_linux_orchestrator_direct_install_claude.sh 2025-10-03 2.9 kB
post_linux_orchestrator_direct_install_claude_miniforge.sh 2025-10-03 3.8 kB
post_linux_orchestrator_task_setup_codebuff_lmstudio.sh 2025-10-03 7.0 kB
post_linux_orchestrator_task_setup_deepcode.sh 2025-10-03 5.9 kB
test-autodev-integration.ps1 2025-10-03 5.4 kB
validate-roadmap.ps1 2025-10-03 2.2 kB
develop-vscode-extension.ps1 2025-10-03 6.2 kB
post-approvals-automation.ps1 2025-10-03 1.9 kB
run-roadmap.ps1 2025-10-03 6.1 kB
start-orchestrator.ps1 2025-10-03 1.2 kB
convert-roadmap.d.ts 2025-10-03 11 Bytes
convert-roadmap.js 2025-10-03 522 Bytes
convert-roadmap.js.map 2025-10-03 510 Bytes
mock-desktop-server.js 2025-10-03 2.2 kB
post_orchestrator_task_install_claude.sh 2025-10-03 3.1 kB
start-mock-desktop.ps1 2025-10-03 245 Bytes
Totals: 24 Items   61.4 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