# Git Worktrees

> Create and manage git worktrees (parallel branches) without stash/switching. Use when this capability is needed.

- Skill: `tomevault-io/git-worktrees-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/git-worktrees-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-worktrees-4/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/git-worktrees-4

---


## Reference

- `docs/dev/worktrees.md`

## Core commands

From the base repo checkout:

- List worktrees: `git worktree list`
- Create branch + worktree: `git worktree add -b feat/my-change ../drasil-wt/my-change origin/main`
- Add worktree for an existing branch: `git worktree add ../drasil-wt/my-change feat/my-change`
- Remove a worktree: `git worktree remove ../drasil-wt/my-change`
- Prune stale metadata: `git worktree prune`

For layout/deps/.env and integration test DB gotchas, see `docs/dev/worktrees.md`.

## Safety

- Do not remove a worktree if it has uncommitted changes.
- Prefer one issue/feature per worktree.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/basic-bit) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

