Changelog - Laravel Worktree

All notable changes to laravel-worktree will be documented in this file.

1.5.0 - 2026-08-01

worktree:teardown now also drops the {name}_test_{token} databases parallel test runs derived from the worktree's databases, covering both paratest worker indexes and mozex/laravel-test-lanes lanes, so they no longer outlive the worktree. Only token-shaped suffixes (digits, or lane plus digits) qualify, which keeps a sibling worktree whose slug happens to extend the prefix untouched, and every discovered name passes the same main-database guard as the worktree's own databases.
Database drops are now keyed by server and name together, so two connections that provision the same database name on different servers both get their database dropped instead of one being quietly left behind.

Full Changelog: 1.4.0...1.5.0

Added an env.replace option that rewrites env values per worktree, such as a Redis or cache prefix. Each entry maps a key to a template built from the worktree's tokens and the key's current value, so the value carries the worktree's slug without a hardcoded handler for it. The rewrites apply to the copied .env and to every file in env.copy.
Added isolation for more than one database connection. List each connection under database.connections, and every worktree gets its own database on all of them, application and test, created on setup and dropped on teardown. Teardown guards each connection against its own database in the main .env. This replaces the single database.name and database.test settings.
Added an opt-in dependencies option that copies vendor and node_modules from the main repository instead of installing them, as long as the worktree's lock file matches. A warm copy of vendor ran about five times faster than composer install in testing. A branch that changed its lock installs normally, and npm ci now lives in this block rather than in steps.
A published config file is now merged with the package defaults one level deeper, so a config written before one of these options existed still receives it instead of losing the whole block.

Full Changelog: 1.3.1...1.4.0

The config defaults for herd and database.migrate are now plain strings instead of enum values. A published config kept the enum imports, and on a production deploy without dev dependencies those classes do not exist, so loading the configuration failed.

Full Changelog: 1.3.0...1.3.1

Added worktree:list, which shows every worktree with its branch, path, URL, and database.
Added an env.copy option that copies extra gitignored env files (.env.testing by default) into the worktree, with the host rewritten.
worktree:setup now resumes a worktree that already exists for the branch, so a failed provisioning step no longer forces a full teardown.
Worktree sites are linked in Herd before being secured. A worktree in a nested path such as .worktrees used to get a certificate for a site that never answered.
Every command now refuses to run from inside a linked worktree and points back at the main repository.
Fixed the test database being created and dropped on the app's default connection instead of the one phpunit.xml pins. A project that develops on SQLite and tests against MySQL used to fail setup outright.
Teardown refuses --pr and --into on a detached worktree, database names are capped at the server's identifier limit, failed commands report their stdout when stderr is empty, and export KEY=value env lines are recognized when isolating child processes.

Full Changelog: 1.2.1...1.3.0

Depend on the split illuminate/* components (console, contracts, filesystem, process, support) instead of laravel/framework. This keeps the package clear of the framework's security advisories while still supporting Laravel 11, 12, and 13.

Full Changelog: 1.2.0...1.2.1

The default Node step is now npm ci instead of npm install. Laravel's package.json ships without a name, so npm install rewrote the tracked package-lock.json with the worktree's own directory name; npm ci installs from the lockfile and leaves it untouched.
Reworked the Warp tab configs with tab titles and clearer names (Create, Resume, Finish).

Full Changelog: 1.1.0...1.2.0

Fixed a blank or quoted branch name creating a repo-'' worktree. A blank branch now auto-generates a name, as the docs always said it would.
Added --print-path to worktree:setup, which prints only the resolved worktree path so a shell button can cd straight into the new worktree.
Fixed the Warp terminal config so leaving the branch blank works and drops you into the worktree, generated name and all.

Full Changelog: 1.0.0...1.1.0

Full Changelog: https://github.com/mozex/laravel-worktree/commits/1.0.0