Skip to main content

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.

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

  1. Start a new feature: Run autowt new-feature. A new terminal tab opens in an isolated directory for that branch.
  2. Get an urgent request: Don't stash! Just run autowt hotfix/urgent-bug. A different terminal tab opens for the hotfix.
  3. Finish the hotfix: Commit, push, and close the hotfix tab.
  4. Return to your feature: Run autowt new-feature again, and autowt will switch you right back to the existing terminal tab for that feature.
  5. Clean up: Once the hotfix branch is merged, run autowt cleanup to 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.

Metadata

Release files for autowt 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for autowt 0.4.1
File Size Uploaded Provenance Actions
autowt-0.4.1.tar.gz 169.8 kB With provenance Details for autowt-0.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for autowt 0.4.1
File Interpreter ABI Platform Actions
autowt-0.4.1-py3-none-any.whl Python 3 none any Details for autowt-0.4.1-py3-none-any.whl

Total release size: 249.5 kB

Release files / autowt-0.4.1.tar.gz

Download URL autowt-0.4.1.tar.gz
Size 169.8 kB
Tags Source
SHA-256 checksum
How to use checksums
4fba0358411de9cb39172d5f08bd2500081b309755dff30331141c6c06e5e41d
BLAKE2b-256 checksum
How to use checksums
ee4abf44b3865048908d6951e906fe8562e668f3d27eabff220f0905ecc39277
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

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 Jul 24, 2025.

Transparency log

Release files / autowt-0.4.1-py3-none-any.whl

Download URL autowt-0.4.1-py3-none-any.whl
Size 79.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c630477ff73552fdf31384d35731c614ce0640c599977e1ee8743d0971c8866b
BLAKE2b-256 checksum
How to use checksums
d50dca439c7e85d58dd759483f53e842eef6d2afed5949a94bb11323cbe92b6e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

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 Jul 24, 2025.

Transparency log

Security for autowt 0.4.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for autowt-0.4.1.tar.gz

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 Jul 24, 2025.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page