Skip to main content

​
Appendix E: worktree.yaml Configuration Reference

# ─── Paths ───────────────────────────────────
worktree_dir: ../trellis-worktrees  # Worktree storage directory (relative path)

# ─── Files to Copy ──────────────────────────
copy:                               # Files needing independent copies per worktree
  - .env
  - .env.local
  - .trellis/.developer

# ─── Post-Create Hooks ──────────────────────
post_create:                        # Commands to run after creation (sequential)
  - pnpm install --frozen-lockfile

# ─── Ralph Loop Verification ────────────────
verify:                             # Quality verification commands (all must pass)
  - pnpm lint
  - pnpm typecheck
  - pnpm test
FieldTypeRequiredDescription
worktree_dirstringNoWorktree storage directory, defaults to ../trellis-worktrees
copystring[]NoList of files to copy to each worktree
post_createstring[]NoCommands to run after worktree creation; aborts on failure
verifystring[]NoRalph Loop verification commands; all must return 0 to pass