osmianski/worktree-manager

Manage Git worktrees with automated port allocation

v0.1.4 2025-11-30 21:14 UTC

Requires

• php: ^8.1
• ext-sockets: *
• symfony/console: ^6.0|^7.0
• symfony/process: ^6.0|^7.0
• symfony/yaml: ^6.0|^7.0

MIT

README

PHP CLI tool for managing Git worktree environments with automated port allocation.

Installation

Install globally via Composer:

composer global require osmianski/worktree-manager

Make sure Composer's global bin directory is in your PATH. Add this to your ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.config/composer/vendor/bin:$PATH"

Usage

Navigate to your Git repository and create a new worktree:

cd /path/to/your/project
worktree new

For contributors

To contribute to a project clone it locally and create a symlink to it in a directory that is already in your path:

cd ~
git clone [e-mail]:osmianski/worktree-manager.git

cd worktree-manager
composer install

# Link `worktree` command to the dev project 
ln -s $HOME/worktree-manager/bin/worktree $HOME/.local/bin/worktree

# To switch back to the globally installed version:
rm $HOME/.local/bin/worktree

License

This project is licensed under the MIT License. See the LICENSE.md file for details.