headless-nwave-worker

Dispatch nwave-ai waves as headless Claude processes in git worktrees.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jzallen/dashboard-chat --skill headless-nwave-worker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headless-nwave-worker
Source: https://github.com/jzallen/dashboard-chat/tree/main/.claude/retired-skills/headless-nwave-worker
Command: npx skills add https://github.com/jzallen/dashboard-chat --skill headless-nwave-worker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires nwave-ai, claude-code, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows users to dispatch long-running nwave-ai waves as headless Claude processes, enabling background execution and isolation of tasks.

Core Features & Use Cases

  • Headless Execution: Run nwave-ai waves as detached processes, allowing for long-running tasks without interrupting the user's workflow.
  • Git Worktree Integration: Create git worktrees from the user's local repository, ensuring all local changes are accounted for.
  • Merge Queue Submission: Submit work to the headless merge queue for content-aware merging and testing.
  • Use Case: Use this Skill to run complex nwave-ai tasks like nw-discover, nw-research, or nw-design in the background, without the need for constant user interaction.

Quick Start

Dispatch a long-running nwave-ai wave as a headless worker by running: claude -p /nw-discover

Frequently Asked Questions about headless-nwave-worker

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

FAQPage Schema
How do I run long-running nwave-ai tasks in the background?

You can run long-running nwave-ai tasks in the background by dispatching them as headless Claude processes. This executes waves like nw-discover or nw-research as detached processes, allowing them to run without interrupting your active workflow.

Do I need git worktrees to run headless nwave-ai waves?

Yes, git worktrees are required to run headless nwave-ai waves. The Skill creates git worktrees from your local repository to execute the background processes, ensuring all local changes are properly accounted for during isolation.

What is the best way to automate complex nwave-ai waves without user interaction?

The best way to automate complex nwave-ai waves without user interaction is dispatching them as headless Claude processes. This method submits the background work to a headless merge queue, where a content-aware gate handles automated testing and merging.

Does the headless merge queue require Claude Code to operate?

Yes, the headless merge queue requires Claude Code to operate. Along with nwave-ai, Claude Code is a necessary dependency for dispatching waves and executing the content-aware gate that decides on testing and merging.

Can I submit background code changes to a merge queue using nwave-ai?

Yes, you can submit background code changes to a merge queue using nwave-ai. The Skill dispatches waves as headless processes in a git worktree and submits the resulting work to a headless merge queue for content-aware merging and testing.

Why use a headless Claude process for nwave-ai background execution?

You use a headless Claude process for nwave-ai background execution to isolate long-running tasks from your local environment. This approach leverages git worktrees and a merge queue to ensure detached processing and automated merging without constant interaction.