gwm

gwm is a CLI tool that wraps Git's worktree feature with an interactive TUI, allowing developers to work on multiple branches simultaneously without repeated stashing and checking out. It solves the friction of context switching when reviewing pull requests, handling hotfixes, or developing features in parallel by creating separate directories for each branch. Key features include fuzzy-searchable branch selection, automatic remote branch creation, merged worktree detection and cleanup, and shell integration for seamless directory navigation. The tool benefits development teams by streamlining Git workflows and reducing manual Git commands through intuitive commands like `gwm add`, `gwm go`, `gwm remove`, and `gwm clean`.

[{"step":1,"action":"Install `gwm` if not already installed. Use your package manager: `brew install gwm` (macOS), `apt install gwm` (Debian/Ubuntu), or follow the [official installation guide](https://github.com/abiosoft/gwm).","tip":"Ensure you have Git 2.23+ installed, as `gwm` relies on modern Git features like `git worktree`."},{"step":2,"action":"Navigate to your Git repository or specify the repository path in the command. Example: `cd ~/projects/my-app` or use the `--repo` flag in the prompt.","tip":"Run `gwm list` to see existing worktrees before taking action. This helps avoid conflicts or duplicate branches."},{"step":3,"action":"Use `gwm` commands to manage your workflow. Common actions include: `gwm switch [branch]`, `gwm create --pr [PR_NUMBER]`, `gwm cleanup --older-than [DAYS]`, or `gwm prune`.","tip":"For PR reviews, use `gwm create --pr [PR_NUMBER]` to automatically clone the PR into a dedicated worktree. This isolates your review environment from other branches."},{"step":4,"action":"After completing your task, clean up stale worktrees to free up disk space. Run `gwm cleanup` regularly or set up a cron job for automated cleanup.","tip":"Use `gwm prune` to remove worktrees that no longer exist on the remote (e.g., after a branch is deleted)."},{"step":5,"action":"Integrate `gwm` into your daily Git workflow. For example, pair it with `git` commands like `git status`, `git diff`, or `git log` within the worktree to maintain context.","tip":"Combine `gwm` with a terminal multiplexer like `tmux` or `zsh` to further optimize your workflow. For example, create a tmux session for each worktree."}]