autowt: a better git worktree experience
autowt is a git worktree manager designed for developers who juggle multiple tasks. It automates the creation, management, and cleanup of git worktrees, giving each branch its own dedicated directory and terminal session. This eliminates context-switching friction, letting you focus on your code.
While powerful for any developer, autowt is a game-changer for those working with command-line AI agents like Claude Code, Gemini CLI, or Codex. It provides the perfect environment for running multiple agents in parallel without interference.
Core features
Automated Worktree Management
autowt handles the entire lifecycle of your worktrees. It automatically creates them in a consistent directory structure, runs your setup scripts, and provides powerful cleanup tools to keep your workspace tidy.
Seamless Terminal Integration
Switching branches is as simple as typing autowt <branch-name>. autowt intelligently manages your terminal sessions, automatically switching to the correct tab or window, or creating a new one if needed. Supports iTerm2, Terminal.app, Ghostty, VSCode, and Cursor on macOS.
AI Agent Ready
Isolate your AI agents in their own worktrees. Run multiple agents on different tasks simultaneously without them tripping over each other's work. autowt provides the perfect sandbox for parallel development and experimentation.
Effortless Cleanup
Keep your repository clean with autowt cleanup. It identifies and removes branches that are merged or have no remote counterpart, ensuring your workspace remains clutter-free.
Getting started
You'll need Python 3.10+ and a version of git released in the last decade (2.5+).
First, install autowt:
pip install autowt
Then, from within a git repository, create a new worktree for a new or existing branch:
autowt my-new-feature
Watch as autowt creates a new worktree and opens it in a new terminal tab or window, ready for you to start coding.
A typical workflow
- Start a new feature: Run
autowt new-feature. A new terminal tab opens in an isolated directory for that branch. - Get an urgent request: Don't stash! Just run
autowt hotfix/urgent-bug. A different terminal tab opens for the hotfix. - Finish the hotfix: Commit, push, and close the hotfix tab.
- Return to your feature: Run
autowt new-featureagain, andautowtwill switch you right back to the existing terminal tab for that feature. - Clean up: Once the hotfix branch is merged, run
autowt cleanupto remove the old worktree and local branch.
Dive deeper
For detailed guides on commands, configuration, and advanced workflows, check out the full documentation.
Contributing
Contributions are welcome! Please feel free to open an issue or submit a pull request.
License
This project is licensed under the MIT License.
1 maintainer
Metadata
1 maintainer
Release files for autowt 0.4.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 | |
|---|---|---|---|
| autowt-0.4.8.tar.gz | 191.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| autowt-0.4.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 285.6 kB
Release files / autowt-0.4.8.tar.gz
| Download URL | autowt-0.4.8.tar.gz |
|---|---|
| Size | 191.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
55d391d52c8e4ed722bedc0760d05953d7d3f26c77265dcbaf8817d8fe4cfd1b
|
|
BLAKE2b-256 checksum How to use checksums |
169fa0ea53a25104df013da51797af7ef5c5c29b78b7c2c1de17b3cfd054fe2c
|
| 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 8, 2025.
Transparency logRelease files / autowt-0.4.8-py3-none-any.whl
| Download URL | autowt-0.4.8-py3-none-any.whl |
|---|---|
| Size | 94.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
27bdc7de3ff85240ff6089c62c5ef70917dd680f458f0766dea7bd525f545b22
|
|
BLAKE2b-256 checksum How to use checksums |
84d151a748989df366a33dc2cf1faa34dc8ca0cdfb3b527454ba0bf075c48a7d
|
| 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 8, 2025.
Transparency log
