Skip to content
Development
Command

/worktree-check

Check current worktree status, branch, and assigned task

From plugin
claude-code-templates
33k200 skills200 agents200 commands2 MCP
$ npx -y skills add davila7/claude-code-templates --agent claude-code

Command definition

worktree-check.md
allowed-tools: Bash(git:*), Bash(cat:*), Bash(pwd:*), Bash(ls:*)
description: Check current worktree status, branch, and assigned task

Worktree Status Check

Verify the current worktree environment and show task details.

Instructions

You are inside a worktree (or the main repo). Gather and display the current status clearly.

Step 1: Detect Worktree

1. Get the current directory: `pwd` 2. List all worktrees: `git worktree list` 3. Determine if the current directory is a worktree (not the main working tree). The main working tree is listed first in `git worktree list` output — if the current path matches the first entry, this is the main repo, not a worktree.

If this is **not** a worktree, inform the user: > You're in the main repository, not a worktree. Use `/worktree-init` to create worktrees.

Then list any existing worktrees and exit.

Step 2: Show Branch Info

1. Get current branch: `git branch --show-current` 2. Verify it follows the `claude/*`, `claude-daniel/*`, or `review/*` naming convention 3. Show how many commits ahead of origin/main: `git rev-list --count origin/main..HEAD`

Step 3: Read Task

1. Check if `.worktree-task.md` exists in the worktree root 2. If it exists, read and display its contents 3. If it doesn't exist, note that no task file was found (may have been created manually)

Step 4: Show Working Status

Run and display: 1. `git status --short` — show modified, staged, and untracked files 2. `git diff --stat` — show a summary of unstaged changes

Step 5: Display Summary

Present a clean summary:

Worktree Status
──────────────────────────────────
Branch:    claude/<name>
Task:      <task description from .worktree-task.md>
Commits:   <N> ahead of main
Modified:  <N> files
Staged:    <N> files
Untracked: <N> files
──────────────────────────────────

If there are changes ready to deliver, suggest: "Run `/worktree-deliver` when you're ready to commit, push, and create a PR."

Read more
@davila7
Ships withclaude-code-templates

Open-source registry and CLI for Claude Code components: agents, commands, skills, hooks, MCPs, settings and mods

33k200 skills200 agents2 MCP
Get the whole plugin

Stars on GitHub

Momentum

stars in total
33.5k
Star history of davila7/claude-code-templates on GitHub, a chart by star-history.com

Other commands on claude-code-templates.

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command