worktree-status

Display branch status, uncommitted changes, and sprint progress for Git worktrees.

17|8|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/michael-harris/devteam --skill worktree-status-michael-harris
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-status
Source: https://github.com/michael-harris/devteam/tree/main/skills/worktree-status
Command: npx skills add https://github.com/michael-harris/devteam --skill worktree-status-michael-harris

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a detailed diagnostic overview of all active Git worktrees, helping to identify and resolve potential issues that could impede development workflows.

Core Features & Use Cases

  • Comprehensive Status: Displays the current branch, commit status (ahead/behind remote), uncommitted changes, and sprint/task completion progress for each worktree.
  • Error Detection: Identifies missing worktrees or branches that are not aligned with the expected configuration.
  • Use Case: Before merging development tracks, use this command to ensure all worktrees are clean, up-to-date, and in a state ready for integration.

Quick Start

Run this command to see the status of all your development worktrees.

Frequently Asked Questions about worktree-status

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

FAQPage Schema
How do I check the status of all my Git worktrees at once?

To check Git worktree status across all active tracks, run a diagnostic command that displays current branches, uncommitted changes, and sprint task progress for each worktree. This identifies missing worktrees and misaligned branches before integration.

What is Git worktree health and why does it matter for development?

Git worktree health tracks branch alignment with remotes, uncommitted changes, and task completion progress across parallel development tracks. Healthy worktrees ensure your sprint branches are clean, up-to-date, and ready for merging without integration conflicts.

How do I verify my Git worktrees are ready for branch merging?

Verify Git worktree merging readiness by diagnosing each worktree for uncommitted changes, remote tracking status, and branch alignment. This ensures all development tracks are clean and up-to-date before you integrate parallel branches.

Can I detect missing Git worktrees or misaligned branches in my repository?

You can detect missing Git worktrees and misaligned branches using worktree diagnostics that compare active development tracks against expected configurations. It flags branches not aligned with remotes and identifies missing worktree directories.

Does Git worktree status tracking work without extra dependencies?

Git worktree status tracking relies solely on standard Git commands and state management scripts to gather configuration and progress metrics. It requires no external dependencies to display branch status and sprint task completion data.

Why are my Git worktree branches showing as not aligned with expected configuration?

Git worktree branches show as misaligned when local commits diverge from the remote tracking branch or when the worktree configuration does not match the expected sprint track. Diagnostics highlight these ahead or behind states for resolution.