skills.rest
open-gsd
open-gsdOFFICIAL
Explore all skills by this author →
Website𝕏@opengsdGitHub

gsd-headless

Execute GSD commands headlessly to orchestrate milestones and workflows.

1.0k|92|Updated May 22, 2026
Search Tags:#automation#cli#orchestration#milestones#headless#workflows#gsd
One-click install
npx skills add https://github.com/open-gsd/gsd-pi --skill gsd-headless-open-gsd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gsd-headless
Source: https://github.com/open-gsd/gsd-pi/tree/main/src/resources/extensions/gsd/skills/gsd-headless
Command: npx skills add https://github.com/open-gsd/gsd-pi --skill gsd-headless-open-gsd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Orchestrates GSD (Git Ship Done) workflows without a UI, enabling automated milestone and task execution from the command line.

Core Features & Use Cases

  • Headless execution of GSD commands (auto/next/query/new-milestone) without user interaction.
  • RPC-based orchestration with automatic prompt handling and answer injection.
  • Real-time visibility with event streaming via --json and selective --events filters.
  • Multi-session and parallel milestone management using the .gsd directory and worktrees.
  • Integrations for orchestrator patterns and external decision logic.

Quick Start

Start a headless session by running gsd headless auto to execute all queued units from a prepared spec and monitor progress from the CLI.

Frequently Asked Questions about gsd-headless

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

FAQPage Schema
How do I automate CLI project orchestration without a GUI?▼

Headless project orchestration executes GSD commands like auto, next, and new-milestone directly from the CLI without a GUI. It manages per-project state under the .gsd directory, enabling automated milestone execution and monitoring.

How do I run multiple milestones in parallel from the command line?▼

You can run multiple milestones in parallel using worktrees and the .gsd directory for multi-session management. The dispatch command coordinates separate parallel workers across worktrees from the CLI.

How does headless mode handle interactive prompts during automated workflows?▼

Headless mode handles interactive prompts using RPC-based orchestration with automatic answer injection and supervised modes. This allows automated workflows to proceed without manual user interaction.

Can I monitor real-time workflow status from the CLI in JSON format?▼

Yes, you can monitor real-time workflow status from the CLI using event streaming with the --json flag. Selective --events filters allow you to track specific status updates during headless execution.

Do I need any external dependencies to run headless project workflows?▼

No external dependencies are required to run headless project workflows. The Skill operates independently, managing state and orchestrating milestones directly through the .gsd directory and CLI commands.

What is the best way to execute all queued units from a prepared spec?▼

The best way to execute queued units from a prepared spec is running the gsd headless auto command. This initiates a headless session to process queued work and monitor progress directly from the CLI.

Related Skills

Explore More Software Engineering Skills→
gsd-buildgsd-build
7.8k

gsd-orchestrator

Orchestrate GSD as a headless subprocess for autonomous software construction.

Official
Advanced
qmuqmu
1

analyze-performance

Evaluate git branch decision-making and output a JSON summary with metrics.

Official
Intermediate
aaronbassettaaronbassett
4

worktrees:orchestrator

Coordinate parallel development across subagents using isolated git worktrees.

Community
Intermediate
qdzshqdzsh
12

gsd-headless

Orchestrate GSD project workflows via headless CLI commands with JSON events.

Community
Advanced