worktree-status

Audit git worktrees and report branch, dirty state, and merge status in Markdown.

12|2|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/haomingz/kimi-skills --skill worktree-status-haomingz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-status
Source: https://github.com/haomingz/kimi-skills/tree/main/skills/worktree-status
Command: npx skills add https://github.com/haomingz/kimi-skills --skill worktree-status-haomingz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit and report the status of all git worktrees in the current project, including the branch, dirty state, and merge status.

Core Features & Use Cases

  • Enumerates every worktree and reports its branch, dirtiness, and merge status.
  • Identifies worktrees that can be safely cleaned based on merge status and cleanliness.
  • Guides pre-cleanup decisions and reduces risk before batch operations.

Quick Start

Run the worktree-status command to generate a Markdown table of all worktrees and their statuses.

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 git worktrees in my repository?

To check git worktree status, audit and report the branch, dirty state, and merge status of all worktrees at once. This generates a Markdown table summarizing which worktrees are safe for cleanup and which branches are merged.

What is the best way to identify which git worktrees can be safely cleaned up?

The best way to identify git worktrees for cleanup is to audit their merge status and dirty state. By checking if a branch is merged and the worktree is clean, you can safely determine which worktrees are ready for batch deletion.

How do I detect squash-merged branches in git worktrees?

To detect squash-merged branches in git worktrees, the audit process performs content diffs against the main branch. It enforces a mandatory pull of the latest main before iterating worktrees to accurately identify squash merge statuses.

Can I audit git worktree merge status before a batch cleanup operation?

Yes, you can audit git worktree merge status before batch cleanup. It guides pre-cleanup decisions by reporting branch dirtiness and merge statuses, reducing the risk of accidentally deleting unmerged or modified worktrees.

Why does auditing git worktree status require pulling the main branch?

Auditing git worktree status requires pulling the main branch to ensure merge statuses are checked against the latest changes. This mandatory pull guarantees accurate content diffs when detecting whether branches are squash-merged.