Using Git Worktrees (trycycle)

Overview

Git worktrees create isolated workspaces sharing the same repository, allowing work on multiple branches simultaneously without switching. Trycycle repos use .worktrees/ as the standard worktree directory.

Create the Worktree

1. Verify .worktrees/ is gitignored

git check-ignore -q .worktrees

If NOT ignored: Add .worktrees to .gitignore and commit before proceeding.

2. Create worktree with new branch

git worktree add .worktrees/<branch-name> -b <branch-name>
cd .worktrees/<branch-name>

3. Run project setup

Auto-detect and run appropriate setup:

# Node.js
if [ -f package.json ]; then npm install; fi

# Rust
if [ -f Cargo.toml ]; then cargo build; fi

# Python (first match wins)
if [ -f poetry.lock ]; then
  poetry install
elif [ -f uv.lock ]; then
  uv sync
elif [ -f pyproject.toml ]; then
  pip install -e .
elif [ -f requirements.txt ]; then
  pip install -r requirements.txt
fi

# Go
if [ -f go.mod ]; then go mod download; fi

4. Report

Worktree ready at <full-path>
Branch: <branch-name>