Commands Overview

GWTree provides a comprehensive set of commands for managing git worktrees. All commands can be invoked using the gwt binary.

Quick Reference

Create

Create new git worktree(s)

List

List all worktrees for current repo

Remove

Remove worktrees interactively

Status

Show status of all worktrees

Clean

Remove merged worktrees

Merge

Merge worktree branch to main

Config

Manage configuration

Flags

Global flags and options

Command List

Core Commands

Command	Aliases	Description
`gwt [names...]`	-	Create new git worktree(s)
`gwt list`	`ls`	List worktrees for current repo
`gwt remove`	`rm`	Remove worktrees interactively
`gwt status`	`st`	Show status of all worktrees (changes, commits ahead/behind)
`gwt clean`	`c`	Remove worktrees that have been merged to main
`gwt merge <name>`	`m`	Merge worktree branch to main and remove worktree
`gwt config [action]`	-	Open config file or reset defaults

Utility Commands

Command	Description
`gwt version`	Show version number
`gwt help`	Show help information
`gwt -v, --version`	Output the version number
`gwt -h, --help`	Display help for command

Global Flags

These flags work with the default gwt command (create):

Flag	Description
`-y, --yes`	Use saved defaults, skip prompts
`-x, --no-editor`	Skip opening editor after creation

For the clean command:

Flag	Description
`-a, --all`	Remove all worktrees (not just merged)

See Flags for detailed information.

Getting Started

The most common workflow:

# Create a new worktree
gwt feature-name

# Check status of all worktrees
gwt status

# Merge and remove when done
gwt merge feature-name

# Or clean up merged worktrees
gwt clean

Version

Current version: 2.0.0

Commands

Options & Flags

​Quick Reference