Why do I need to run the Worktree Plus Setup skill?

It registers necessary hooks in your settings.json file so Claude Code uses worktree-plus enhancements, like symlink preservation, instead of the default worktree system.

What happens to my existing Git hooks?

The setup script is designed to be non-destructive; it appends or updates the specific worktree-plus hooks while preserving any other existing hooks in your configuration.

Do I need to restart Claude after running the setup?

Yes, hook registration is loaded at session startup, so you must restart Claude Code for the new settings to take effect.

Is 'jq' required for this skill to work?

Yes, 'jq' is mandatory for JSON manipulation. The setup will fail or fall back to default behavior if 'jq' is not installed on your system.

Where are the hook settings stored?

The skill detects your install scope and writes to ~/.claude/settings.json (user), .claude/settings.json (project), or .claude/settings.local.json (local).

Worktree Plus Setup

Name: Worktree Plus Setup
Author: LeeJuOh

byLeeJuOh

•

Developer Tools

Configures custom Git worktree hooks in Claude Code to enable enhanced workspace isolation and management.

The Worktree Plus Setup skill automates the registration of WorktreeCreate and WorktreeRemove hooks within Claude Code's configuration files. It intelligently scans for your plugin installation scope—whether user-level, project-level, or local—and updates the corresponding settings.json to ensure that 'claude -w' utilizes worktree-plus enhancements rather than the built-in default behavior. This skill is essential for developers seeking to maintain persistent environment settings, symlinks, and specialized file inclusions across their ephemeral Git worktrees.

Key Features

01Smart JSON manipulation that preserves existing third-party hooks

0229 GitHub stars

03Automated registration of WorktreeCreate and WorktreeRemove hooks

04Dependency validation for jq to ensure reliable JSON parsing

05Intelligent detection of User, Project, and Local settings scopes

06Auto-updates stale hook paths and repairs missing configurations

Use Cases

01Enabling advanced worktree features when Claude defaults to standard behavior

02Resolving hook registration warnings during Claude Code session startup

03Configuring project-specific worktree behaviors for team environments

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add leejuoh/claude-code-zero setup

For use in Claude.ai and ChatGPT