listing-worktrees

Parse git worktree list --porcelain output and filter autonomy worktrees.

3|1|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/tilmon-engineering/claude-skills --skill listing-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: listing-worktrees
Source: https://github.com/tilmon-engineering/claude-skills/tree/main/plugins/autonomy/skills/listing-worktrees
Command: npx skills add https://github.com/tilmon-engineering/claude-skills --skill listing-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers quickly view all autonomy worktrees and their status, enabling faster navigation and management of parallel work environments.

Core Features & Use Cases

  • List active autonomy worktrees: Provides a concise view of currently checked-out worktrees under .worktrees/autonomy.
  • Status-aware navigation: Helps identify locked or stale worktrees and locate their paths for management.
  • Use Case: When you run /list-worktrees, you can identify which autonomy worktrees exist and where they live to switch contexts or perform maintenance.

Quick Start

  • Execute the /list-worktrees command and review the autonomy worktrees section for details.

Frequently Asked Questions about listing-worktrees

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

FAQPage Schema
How do I list git worktrees and check their statuses in a repository?

You can list git worktrees and check their statuses by executing a command that parses `git worktree list --porcelain` output, filtering for the `.worktrees/autonomy` directory to return a human-friendly table of paths, HEAD commits, and lock states.

What is an autonomy worktree and when do I need to manage it?

An autonomy worktree is a parallel working directory under `.worktrees/autonomy` used for independent tasks. You need to manage it when identifying active worktrees, locating their paths, or performing maintenance on locked or stale environments.

How do I find the HEAD commit and lock state for my active worktrees?

To find the HEAD commit and lock state for active worktrees, parse the porcelain output of the git worktree list command, which filters checkout directories and returns their current commit hashes and lock statuses.

Does this worktree listing approach filter for a specific directory path?

Yes, the worktree listing approach specifically filters the parsed git output to target the `.worktrees/autonomy` directory path, ensuring only relevant parallel work environments are displayed in the resulting status table.

Why are my git worktrees showing as locked and how can I identify them?

Git worktrees show as locked when explicitly marked or during specific git operations. You can identify locked worktrees by running a listing command that parses porcelain output and explicitly highlights the lock state alongside the worktree path.