ws-branch

Create, remove, and navigate worktrees in ws-managed bare repositories.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/langify-org/ws-cli --skill ws-branch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ws-branch
Source: https://github.com/langify-org/ws-cli/tree/main/plugin/skills/ws-branch
Command: npx skills add https://github.com/langify-org/ws-cli --skill ws-branch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage worktrees in a ws-managed repository by creating, removing, or switching between them without manual git gymnastics.

Core Features & Use Cases

  • Create new worktrees for branches in a ws-managed bare repository.
  • Remove existing worktrees safely with pre-checks for uncommitted changes and unpushed commits.
  • Guide users to the correct worktree directory when switching, keeping branch worktrees organized.

Quick Start

Create a new worktree for a branch by running ws new <branch-name>.

Frequently Asked Questions about ws-branch

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

FAQPage Schema
How do I create a git worktree for a new branch in a bare repository?

Creating a git worktree in a bare repository is automated by running a command like ws new <branch-name>, which sets up the worktree directory and links the branch without manual git worktree add arguments.

How do I safely remove a git worktree without losing uncommitted changes?

Safely removing a git worktree requires pre-checks for uncommitted changes and unpushed commits. The removal process verifies your working directory is clean before deleting the worktree folder and cleaning up git metadata.

How do I switch between git worktrees in a development workflow?

Switching between git worktrees involves navigating to the specific directory where the branch is checked out. The system guides you to the correct worktree folder path, keeping branch worktrees organized in the bare repository structure.

Does this worktree management approach work with bare clone repositories?

Yes, this worktree management approach is specifically designed for bare clone repositories. It applies to ws workflows in bare clone plus worktree setups, handling branch creation and navigation within the bare repo architecture.

What is the best way to manage multiple worktrees for different branches?

Managing multiple worktrees is best handled by using a ws-managed bare repository. This approach automates worktree creation, safe removal with uncommitted change checks, and directory-based navigation to keep branch worktrees organized.