worktree-list

List git worktrees and return the selected path and branch.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/leessju/claude-skills --skill worktree-list-leessju
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: worktree-list
Source: https://github.com/leessju/claude-skills/tree/main/worktree-list
Command: npx skills add https://github.com/leessju/claude-skills --skill worktree-list-leessju

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill requires git, gum, and includes scripts (resource) components.

What problem does it solve?

์ €์žฅ์†Œ์—์„œ ์—ฌ๋Ÿฌ ์›ŒํฌํŠธ๋ฆฌ(worktree)๊ฐ€ ๊ด€๋ฆฌ๋  ๋•Œ, ๊ฐ๊ฐ์˜ ๊ฒฝ๋กœ์™€ ๋ธŒ๋žœ์น˜๋ฅผ ํ™•์ธํ•˜๋ฉฐ ์ด๋™ํ•ด์•ผ ํ•˜๋Š” ๋ฒˆ๊ฑฐ๋กœ์›€์„ ์ค„์—ฌ ๋น ๋ฅด๊ฒŒ ์›ํ•˜๋Š” ์›ŒํฌํŠธ๋ฆฌ๋กœ ์ „ํ™˜ํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•์Šต๋‹ˆ๋‹ค.

Core Features & Use Cases

  • ์›ŒํฌํŠธ๋ฆฌ ๋ชฉ๋ก์„ ์กฐํšŒํ•˜๊ณ  ๊ฐ ํ•ญ๋ชฉ์˜ ๊ฒฝ๋กœ, ๋ธŒ๋žœ์น˜ ์ •๋ณด๋ฅผ ํ•œ ๋ฒˆ์— ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.
  • ํ˜„์žฌ HEAD๊ฐ€ ์œ„์น˜ํ•œ ์›ŒํฌํŠธ๋ฆฌ๋Š” "(ํ˜„์žฌ)"๋กœ ํ‘œ์‹œ๋˜์–ด ๋น ๋ฅด๊ฒŒ ์‹๋ณ„ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
  • INTERACTIVE ๋ชจ๋“œ๊ฐ€ ๊ฐ€๋Šฅํ•˜๋ฉฐ Claude Code Bash์—์„œ ๋น„๋Œ€ํ™”ํ˜• ๋ชจ๋“œ์—์„œ๋„ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค(๋‹จ, ๋Œ€ํ™”ํ˜• ์‚ฌ์šฉ์€ gum์ด ์„ค์น˜๋œ ํ™˜๊ฒฝ์—์„œ ์ตœ์ ํ™”๋ฉ๋‹ˆ๋‹ค).

Quick Start

ํ˜„์žฌ ์ €์žฅ์†Œ์˜ ์›ŒํฌํŠธ๋ฆฌ ๋ชฉ๋ก์—์„œ ์ด๋™ํ•  ์›ŒํฌํŠธ๋ฆฌ ํ•˜๋‚˜๋ฅผ ์„ ํƒํ•˜๋„๋ก choose.sh ์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‹คํ–‰ํ•œ๋‹ค.

Frequently Asked Questions about worktree-list

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

FAQPage Schema
How do I switch between multiple git worktrees from the command line?โ–ผ

To switch git worktrees, you can use an automated bash script that lists all worktrees with their paths and branches, marking the current HEAD location as active, and returns the selected worktree path for immediate navigation.

What is the best way to view and manage git worktree paths and branches?โ–ผ

Viewing git worktree paths and branches is done by running a script that gathers worktree data and displays each entry alongside its branch information, highlighting the currently active worktree for quick identification.

Can I use interactive selection to navigate git worktrees without gum installed?โ–ผ

You can navigate git worktrees without gum by utilizing the non-interactive mode within Claude Code Bash, which executes the deterministic workflow automatically, though interactive selection is optimized only when gum is installed.

Does git worktree navigation work in non-interactive command-line environments?โ–ผ

Git worktree navigation works in non-interactive command-line environments by executing a deterministic bash script that gathers worktree data and returns the selected path and branch without requiring user input.

Why use a dedicated script for git worktree selection instead of standard git commands?โ–ผ

A dedicated script for git worktree selection reduces the friction of manually checking paths and branches, providing an automated workflow that views, selects, and moves between multiple worktrees efficiently from the command line.