PHPackages                             osmianski/worktree-manager - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. osmianski/worktree-manager

ActiveLibrary[Utility & Helpers](/categories/utility)

osmianski/worktree-manager
==========================

Need to maintain multiple working branches simultaneously - whether for long-term parallel development or running AI agents in separate worktrees? Setting up each environment is tedious. This tool creates worktrees with fully working environments in seconds.

v0.1.10(4mo ago)06[1 issues](https://github.com/osmianski/worktree-manager/issues)MITPHPPHP ^8.1

Since Nov 30Pushed 4mo agoCompare

[ Source](https://github.com/osmianski/worktree-manager)[ Packagist](https://packagist.org/packages/osmianski/worktree-manager)[ RSS](/packages/osmianski-worktree-manager/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (10)Used By (0)

Need to maintain multiple working branches simultaneously - whether for long-term parallel development or running AI agents in separate worktrees? Setting up each environment is tedious.

This tool automates it: create worktrees with fully working environments in seconds, automatically allocate ports, install dependencies, create Docker containers and migrate data.

Installation
------------

[](#installation)

**Requirements:** PHP 8.1 or higher

1. Install globally via Composer:

    ```
    composer global require osmianski/worktree-manager
    ```
2. Make sure Composer's global `bin` directory is in your PATH. The location varies by system:

    ```
    # Most Linux systems
    export PATH="$HOME/.config/composer/vendor/bin:$PATH"

    # Or on some systems
    export PATH="$HOME/.composer/vendor/bin:$PATH"
    ```

    Add the appropriate line to your `~/.bashrc` or `~/.zshrc`.
3. Verify the installation:

    ```
    worktree --version
    ```

Usage
-----

[](#usage)

Navigate to your Git repository and create a new worktree:

```
cd /path/to/your/project
worktree new
```

For contributors
----------------

[](#for-contributors)

To contribute to a project clone it locally:

```
cd ~
git clone git@github.com:osmianski/worktree-manager.git

cd worktree-manager
composer install
```

To run the dev version in a terminal session, run the following command:

```
export PATH="$HOME/worktree-manager/bin:$PATH"
```

Now if you run `worktree`, it should show the branch name instead of the version number:

```
Worktree Manager dev-main

```

License
-------

[](#license)

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance75

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~10 days

Recently: every ~19 days

Total

9

Last Release

135d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/70505ad13b7a3f67344988bd0f17f6a5c6bc29919300c7e12d937882eebc3080?d=identicon)[osmianski](/maintainers/osmianski)

---

Top Contributors

[![osmianski](https://avatars.githubusercontent.com/u/522822?v=4)](https://github.com/osmianski "osmianski (44 commits)")

### Embed Badge

![Health badge](/badges/osmianski-worktree-manager/health.svg)

```
[![Health](https://phpackages.com/badges/osmianski-worktree-manager/health.svg)](https://phpackages.com/packages/osmianski-worktree-manager)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.7k38.9k](/packages/matomo-matomo)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21866.0M1.7k](/packages/drupal-core)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6942.5M421](/packages/drupal-core-recommended)[kimai/kimai

Kimai - Time Tracking

4.8k9.0k1](/packages/kimai-kimai)[phpactor/phpactor

PHP refactoring and intellisense tool for text editors

1.9k17.1k1](/packages/phpactor-phpactor)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)