git-wt
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 worktreeshooks.post_create: List of scripts to run after creating a worktree
Why?
When working with git worktrees, you often need to:
- Copy environment files (.env, .envrc) to each new worktree
- Run setup scripts (install dependencies, etc.)
git-wt automates this workflow.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for git-wt 0.1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| git_wt-0.1.8.tar.gz | 15.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| git_wt-0.1.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.4 kB
Release files / git_wt-0.1.8.tar.gz
| Download URL | git_wt-0.1.8.tar.gz |
|---|---|
| Size | 15.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
288956638353e294189d3ed258645ef886ef00edbc37c5f51a964ade859cfb7b
|
|
BLAKE2b-256 checksum How to use checksums |
185935cb19fa4390ade8b11c7d901fc3bac2e4e4fc2f53655ec54a8071881e1c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.13
|
Release files / git_wt-0.1.8-py3-none-any.whl
| Download URL | git_wt-0.1.8-py3-none-any.whl |
|---|---|
| Size | 9.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a10069d16cd490443f3850d23985c504520419e9a259ce1a8e82b7bae1b3d4b0
|
|
BLAKE2b-256 checksum How to use checksums |
1b1f267fccebbe48c50e0ca128ac049edc5cee9fbd0780d0e8754c326b04f50b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.13
|
