gsd-headless

Orchestrate GSD projects from a headless CLI with RPC child processes.

7.8k|770|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/gsd-build/gsd-2 --skill gsd-headless
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-headless
Source: https://github.com/gsd-build/gsd-2/tree/main/src/resources/extensions/gsd/skills/gsd-headless
Command: npx skills add https://github.com/gsd-build/gsd-2 --skill gsd-headless

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Orchestrate GSD projects from the command line by running a headless orchestrator that can bootstrap milestones, execute workflows, and monitor progress without a terminal UI.

Core Features & Use Cases

  • Spawns an RPC child process and auto-responds to UI prompts during headless runs.
  • Creates milestones from specs, chains auto-mode, and tracks progress across multiple tasks.
  • Monitors project status, manages execution (pause/stop/steer), and streams real-time updates to clients.

Quick Start

Invoke gsd headless to create and execute a milestone from a spec file, enabling automatic orchestration of all workflow phases.

Frequently Asked Questions about gsd-headless

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I orchestrate headless CLI workflows for project automation?

Headless CLI workflows orchestrate project automation by spawning an RPC child process that auto-responds to UI prompts, enabling programmatic execution without a terminal UI. This allows you to bootstrap milestones and run tasks seamlessly in the background.

Can I create milestones from spec files and execute them automatically?

Yes, you can create milestones from spec files and execute them automatically. The headless orchestrator chains auto-mode to bootstrap milestones from specs, runs associated workflows, and tracks task progress programmatically across multiple phases.

Does headless project orchestration support multi-session parallel execution?

Headless project orchestration supports multi-session parallel execution for scalable project management. It manages multiple concurrent sessions, allowing you to monitor project status and control execution across parallel workflows simultaneously.

How do I monitor task progress and stream real-time updates in a headless environment?

You monitor task progress and stream real-time updates in a headless environment using JSONL event output. The orchestrator streams real-time status updates to clients, capturing workflow execution data without requiring an interactive terminal UI.

What is the best way to control execution flow like pause or stop in automated workflows?

The best way to control execution flow like pause or stop in automated workflows is through headless orchestration commands. You can programmatically pause, stop, or steer GSD execution during runtime to manage task progression dynamically.

Do I need an interactive terminal UI to run GSD automation workflows?

No, you do not need an interactive terminal UI to run GSD automation workflows. The headless orchestrator automates end-to-end execution by auto-responding to UI prompts and injecting answers programmatically via RPC child processes.