Gestor de Worktrees Git

Repositorio

cultivashop

Rama base

main

Stack

Next.js 14 · PostgreSQL 15 · Redis 7

Agentes activos

3 ingenieros / sesiones paralelas

Worktrees totales

Activos y limpios

Candidato eliminación

Bloqueado (dirty)

01 · creación de worktree wt-auth

$ python3 scripts/worktree_manager.py \ --repo ~/projects/cultivashop \ --branch feature/new-auth \ --name wt-auth \ --base-branch main \ --install-deps \ --format json

worktree_manager.py — output JSON

repo/home/dev/projects/cultivashop

worktree_path/home/dev/projects/wt-auth

branchfeature/new-auth

created✓ true

dependency_installinstalled via pnpm install

Archivos .env copiados

.env.local .env.development

Puertos asignados — .worktree-ports.json

App (Next.js)

3010

localhost:3010

PostgreSQL

5442

localhost:5442

Redis

6389

localhost:6389

{ "app": 3010, "db": 5442, "redis": 6389 }

02 · checklist de validación post-creación

✓ git worktree list muestra /home/dev/projects/wt-auth feature/new-auth
✓ .worktree-ports.json existe con puertos únicos (3010 / 5442 / 6389)
✓ pnpm install completado con código 0 (1.204 paquetes)
✓ .env.local y .env.development copiados desde repo principal
✓ App arranca en localhost:3010 (sin conflicto con rama main ni wt-checkout)

03 · reporte de limpieza semanal

$ python3 scripts/worktree_cleanup.py \ --repo ~/projects/cultivashop \ --stale-days 14 \ --remove-merged \ --format text

worktree_cleanup.py — scan report

Worktree	Rama	Edad	Estado	Stale	Dirty	Mergeado	Acción
~/projects/cultivashop	main	—	● Main	—	—	—	intocable
~/projects/wt-checkout	feature/new-checkout	3 días	● Activo	✓ No	✓ No	✗ No	mantener
~/projects/wt-auth	feature/new-auth	1 día	★ Nuevo	✓ No	✓ No	✗ No	mantener
~/projects/wt-perf	hotfix/perf-db-indexes	18 días	⚠ Stale	⚠ Sí	✓ No	✓ Sí	✗ ELIMINADO
~/projects/wt-i18n	feature/i18n-support	22 días	⛔ Stale+Dirty	⚠ Sí	✗ Sí — 3 archivos	✗ No	bloqueado (dirty)

Eliminado automáticamente

Worktree: wt-perf

Rama: hotfix/perf-db-indexes

Razón: stale (18d) + mergeado + clean

Comando: git worktree remove ~/projects/wt-perf

✓ Eliminado con éxito. Espacio liberado: 847 MB

Acción manual requerida

Worktree: wt-i18n

Problema: 3 archivos sin commit

Archivos: src/i18n/es.json, src/i18n/en.json, README.md

⚠ Revisar cambios antes de eliminar

Usar --force solo si se descarta intencionalmente

04 · mapa de puertos activo post-limpieza

Puerto asignado por worktree activo

Worktree	Rama	App Port	PostgreSQL	Redis	Dev Server
cultivashop main	main	3000	5432	6379	next dev
wt-checkout	feature/new-checkout	3010	5442	6389	next dev -p 3010
wt-auth nuevo	feature/new-auth	3020	5452	6399	next dev -p 3020

Gestor de Worktrees Git — CultivaShop