hx-headless

Automate HX milestone and task orchestration from a headless CLI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/HyperDev1/hx-ai --skill hx-headless
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hx-headless
Source: https://github.com/HyperDev1/hx-ai/tree/main/src/resources/extensions/hx/skills/hx-headless
Command: npx skills add https://github.com/HyperDev1/hx-ai --skill hx-headless

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Orchestrate HX milestones and tasks from a headless CLI to automate orchestration without a UI, enabling programs to create milestones, execute workflows, monitor progress, and control execution.

Core Features & Use Cases

  • Headless orchestration: run and manage HX milestones from scripts, with deterministic task execution and RPC-driven communication.
  • End-to-end workflows: bootstrap projects, execute plans, monitor progress, and adjust execution in real-time.
  • Use Case: integrate into CI pipelines to automatically spin up a milestone from a spec, run all phases, and produce a completion summary.

Quick Start

Run hx headless auto to begin processing all queued units.

Frequently Asked Questions about hx-headless

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

FAQPage Schema
How do I automate project orchestration from a CLI without a UI?

To automate milestones from a headless CLI, you run the hx headless auto command to process all queued units. This enables programs to bootstrap projects, execute plans, and control execution deterministically without a UI.

Can I integrate milestone orchestration into a CI pipeline?

Yes, you can integrate headless CLI orchestration into CI pipelines to automatically spin up a milestone from a spec, run all phases, and produce a completion summary. It supports auto-run flags and JSON events for automated execution.

Do I need the hx headless tool to run workflows?

Yes, the hx headless tool is required to orchestrate milestones and tasks from a headless CLI. It provides the RPC-driven communication and deterministic task execution needed for end-to-end workflow automation.

What is supervised mode in headless workflow orchestration?

Supervised mode is a flag in headless CLI orchestration that ensures deterministic, auditable execution of workflows. It allows you to monitor progress and adjust execution in real-time while running tasks from the CLI.

How do I monitor progress and report status for automated milestones?

Headless orchestration supports JSON events to monitor progress and report status during task execution. By running the hx headless tool with context flags, you can track workflow phases and generate a completion summary automatically.