v0.3.0

Highlights

• Adds wtg new BRANCH --enter, which opens a visibly nested interactive shell directly in the new worktree after Grove releases its mutation lock. Run wtg done && exit when finished.
• Adds wtg update --check and wtg update for standard uv and pipx tool installations.
• Self-update accepts only a stable immutable GitHub release named exactly like its vX.Y.Z tag, verifies GitHub asset digests, SHA256SUMS, wheel structure and metadata, exact manager ownership, and the resulting installation.
• Standardizes every GitHub release title on its exact version tag.
• Updates the README GIF and transcript using a real v0.3.0 --enter session.

Upgrade from v0.2.x

v0.2.x predates wtg update, so install v0.3.0 once from the verified wheel and SHA256SUMS assets below. Future releases can then use wtg update.

Existing project configs commonly pin required_version = "0.2.0". After installing v0.3.0, deliberately change that exact pin to required_version = "0.3.0". Grove never rewrites repository policy during self-update.

Verification

Release assets passed the full test suite, package rebuild and artifact checks, Linux/macOS compatibility on Python 3.10–3.14, and real isolated self-replacement smoke tests through uv and pipx on both operating systems.

v0.2.0

Highlights

• Centralizes new repository pools under ~/.worktree_grove/<repository-name>-<id>.
• Adds the human-oriented wtg new, list, show, path, and token-free done workflow.
• Runs configured preparation automatically for new, with retryable deterministic failures.
• Adds explicit remove --dry-run for available slots.
• Adds snapshot-backed discard --dry-run for active and quarantined slots, preserving separate worktree and staged-index recovery refs.
• Keeps strict JSON acquire and proof-gated release behavior for automation compatibility.

Upgrade notes

Existing v0.1 pools remain at their recorded or safely inferred location; Grove does not move them automatically. New repositories use the centralized home-directory layout. Project configs pinned to an earlier exact required_version must be deliberately updated to 0.2.0.

Install

Download the wheel and SHA256SUMS, verify the checksum, then install the verified wheel with uv tool install or pipx.

The release also includes the source archive and bundled Worktree Grove agent skill.

v0.1.4

Highlights

• Hardened fail-closed repository routing, transport URL validation, pool ancestry, worktree locks, and remote-ref ownership checks.
• Added strict private-state and nested-state validation, plus quarantine behavior for interrupted lifecycle transitions.
• Scoped lease capabilities to individual wtg processes in the README, CLI help, and bundled agent skill.
• Added exact wheel/sdist/source verification, expanded compatibility testing through Python 3.14, and stronger release tag/default-branch checks.
• Replaced the long README with a concise public quick start and product demo.
• Updated pinned GitHub Actions to their reviewed current major versions.

Download the wheel, source distribution, or agent skill below. SHA256SUMS verifies that downloaded assets match this release; because it is colocated with the assets, it is not independent publisher authentication.

Full changelog: v0.1.3...v0.1.4

v0.1.3

Worktree Grove v0.1.3 prevents agent acquisition examples from stranding leases on hosts without a python alias.

• README, CLI help, and the installable agent skill now use the guaranteed python3 executable for post-acquisition token/path parsing.
• Regression tests prevent examples from reverting to python.
• CI artifact validation now derives filenames from the project version.

All artifacts were built and tested on Linux and macOS with Python 3.10–3.13. Verify downloads with SHA256SUMS.

v0.1.2

Worktree Grove v0.1.2 adds repository policy locks and safe cleanup globs.

Highlights:

• Projects can set allow_acquire_overrides = false to reject --base, --remote, and --max-slots before any pool mutation.
• cleanup_globs safely removes only matching ignored or untracked porcelain candidates.
• preserve_paths takes precedence over cleanup globs.
• Lowered capacity is enforced against all recorded slots.
• Rename/copy porcelain records and literal cleanup path checks are handled fail-closed.

All artifacts were built and tested on Linux and macOS with Python 3.10–3.13. Verify downloads with SHA256SUMS.

v0.1.1

Worktree Grove v0.1.1

Adds generic release-containment gates while preserving the v0.1 fail-closed lifecycle.

Added

• Per-branch required_containment_targets configuration
• Changed-release verification that the exact merge-target tip is contained in every required target before cleanup or ref deletion
• Structured proof-containment failures that preserve the active lease and local/remote task refs
• Status/config visibility for the snapshotted containment policy

This supports workflows such as requiring main to be back-merged into preview before recycling a merged hotfix/* lease.

Install

Download the wheel and SHA256SUMS, verify the named wheel entry, then install:

uv tool install ./worktree_grove-0.1.1-py3-none-any.whl
# or
pipx install ./worktree_grove-0.1.1-py3-none-any.whl

v0.1.0

Worktree Grove v0.1.0

Initial public release of wtg, a fail-closed reusable Git worktree pool for humans and coding agents.

Highlights

• Six lazy, stable worktree slots by default under <project-parent>/.worktrees/<project-name>
• Explicit -C/--repo support for agents invoking from other directories
• Human-readable output and stable JSON envelopes
• Configurable branch/base policy, pool size, preparation fingerprints, preserved caches, and cleanup allowlists
• Exact GitHub PR, Git ancestry, or no-change release proofs
• Required lease capabilities, owner metadata, quarantine, doctor diagnostics, and SHA-1/SHA-256 recovery refs
• Bundled Agent Skill with pinned installation and safe lifecycle instructions
• Linux/macOS support across Python 3.10–3.13

Install

Download the wheel and SHA256SUMS, verify the named wheel entry, then install:

uv tool install ./worktree_grove-0.1.0-py3-none-any.whl
# or
pipx install ./worktree_grove-0.1.0-py3-none-any.whl

See the README for checksum commands, configuration, and the agent workflow.