Skip to main content

git-wt

PyPI version

A lightweight CLI tool for managing git worktrees with automatic file syncing and post-create hooks.

Install

uv tool install git-wt
# or
pipx install git-wt
# or
pip install git-wt

Usage

cd your-repo
git wt        # as a git subcommand
# or
git-wt        # standalone

On first run, you'll be prompted to create a config file.

Features

  • Create worktrees with branch autocomplete
  • Auto-copy or symlink configured files (.env, .envrc, etc.)
  • Run post-create hooks (setup scripts)
  • List worktrees with dirty status
  • Remove worktrees with safety prompts
  • Path copied to clipboard on creation

Config

On first run, git-wt will prompt you to create .git-wt.toml in your repo root:

[files]
mode = "copy"  # or "symlink"
paths = [".env", ".envrc"]

[hooks]
post_create = ["./setup.sh"]

Options

  • files.mode: "copy" (default) or "symlink"
  • files.paths: List of files/directories to sync to new worktrees
  • hooks.post_create: List of scripts to run after creating a worktree

Why?

When working with git worktrees, you often need to:

  1. Copy environment files (.env, .envrc) to each new worktree
  2. Run setup scripts (install dependencies, etc.)

git-wt automates this workflow.

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

git_wt-0.1.8.tar.gz (15.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

git_wt-0.1.8-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

Details for the file git_wt-0.1.8.tar.gz.

File metadata

  • Download URL: git_wt-0.1.8.tar.gz
  • Upload date:
  • Size: 15.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.13

File hashes

Hashes for git_wt-0.1.8.tar.gz
Algorithm Hash digest
SHA256 288956638353e294189d3ed258645ef886ef00edbc37c5f51a964ade859cfb7b
MD5 ea3327a687d76840718f9a661100b3d2
BLAKE2b-256 185935cb19fa4390ade8b11c7d901fc3bac2e4e4fc2f53655ec54a8071881e1c

See more details on using hashes here.

File details

Details for the file git_wt-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: git_wt-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 9.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.13

File hashes

Hashes for git_wt-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 a10069d16cd490443f3850d23985c504520419e9a259ce1a8e82b7bae1b3d4b0
MD5 60eaa5d339d0b671467d0c4627c27cd4
BLAKE2b-256 1b1f267fccebbe48c50e0ca128ac049edc5cee9fbd0780d0e8754c326b04f50b

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.8 This release

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page