This release is a pre-release and may not be stable for production use.
autowt: a better git worktree experience
autowt is a layer of convenience over git worktree. It automates the creation, management, and cleanup of git worktrees, giving each branch its own dedicated directory and terminal tab or window.
Consider what it takes to set up a fresh worktree in a typical workflow:
- Make a decision about where to put the worktree
git worktree add <worktree_path> -b <branch>- Open a new terminal tab
cd <worktree path>uv syncornpm installor whatever your dependency setup iscp <repo_dir>/.env .to copy secrets
Congrats, you're done! Type type type, open a PR, and merge it. Now you need to clean up:
git worktree rm .- Close the tab
Of course, you might close the tab and forget to clean up the worktree, and your set of worktrees will grow.
On the other hand, with autowt, it looks like this:
autowt <branch>
# there is no step 2
And deleting branches that have been merged or are associated with closed PRs looks like this:
autowt cleanup
A lot nicer, right?
Type less
The built-in worktree commands are verbose. autowt makes them shorter, and adds automation hooks.
Terminal program automation
If you like to keep multiple tabs open, autowt can create tabs for new worktrees, and switch to the correct tab for a worktree if you already have it open.
Getting started
You'll need Python 3.10+ and a version of git released less than ten years ago (2.5+).
First, install autowt:
pip install autowt
Then, make a new worktree for a new or existing branch in your current repo:
autowt my-new-feature
Watch as autowt creates a new worktree and opens it in a new terminal tab or window.
Contributing
PRs, GitHub issues, discussion topics, bring 'em on!
License
This project is licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for autowt 0.5.0.dev2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| autowt-0.5.0.dev2.tar.gz | 171.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| autowt-0.5.0.dev2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 237.4 kB
Release files / autowt-0.5.0.dev2.tar.gz
| Download URL | autowt-0.5.0.dev2.tar.gz |
|---|---|
| Size | 171.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7c34c3ca8bd19c6aa4fa6fc70363d9c2d8ca344a8ca5416d8dd7898aa6708670
|
|
BLAKE2b-256 checksum How to use checksums |
9ca2f75bf64f72e2ea6e257f322269084446dae37a63dd483715df785804a9ab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2025.
Transparency logRelease files / autowt-0.5.0.dev2-py3-none-any.whl
| Download URL | autowt-0.5.0.dev2-py3-none-any.whl |
|---|---|
| Size | 65.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7b892e83dcbb24e15326375faa397c2f834ea6a0685dd9b7b1a93077c2c58ab6
|
|
BLAKE2b-256 checksum How to use checksums |
8778668a0efe398e521aef37a9bdae4c7792b249356723b9f9b7b4f07af8070d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 16, 2025.
Transparency log
