getworktree 0.1.1.dev54

Isolated git worktree developer loops and AI agent workspaces.

Worktree (wt)

Isolated git worktree developer loops and autonomous AI agent workspaces.

Worktree helps humans and agents build, test, and remediate in parallel without disturbing your active local branch.

Installation

pip install getworktree

Optional provider extras:

pip install "getworktree[cursor]"

Requirements

• Python 3.13+
• Git
• For provider-specific loop runs:
  • Cursor: CURSOR_API_KEY (+ getworktree[cursor])
  • Gemini: Gemini CLI on PATH + GEMINI_API_KEY
  • Copilot: GitHub CLI (gh) on PATH + GH_TOKEN or GITHUB_TOKEN

Quick start

wt init
wt status
wt config validate
wt loop show fix-tests
wt loop run fix-tests

Current command surface

Top-level

• wt init
• wt status

Config

• wt config show
• wt config validate

Loop

• wt loop show <name>
• wt loop run <name>

Agent providers for loop runs

Loop definitions support these providers:

• local
• ollama
• cursor
• gemini
• copilot

Provider behavior:

• local and ollama return unified diffs
• cursor, gemini, and copilot run as direct-mutation providers with shared safety gates before patches are accepted

Project layout

Worktree initializes and uses:

• .worktree/config.json
• .worktree/loops/*.yml
• .worktree/sessions/
• .worktree/artifacts/

Development

pip install -e .[dev]
inv test
ruff format .
ruff check .

Documentation

• CLI plan: docs/cli-plan.md
• Schemas and config: docs/agents/schemas-and-config.md
• Architecture: docs/agents/architecture.md

Project status

This README reflects the currently implemented surface in main. Additional commands listed in docs/cli-plan.md may still be in progress.

License

Distributed under the MIT License. See LICENSE for details.

Links

• Website: getworktree.io
• GitHub Organization: github.com/getworktree