Extensión de Visual Studio Code para visualizar y gestionar los
git worktrees de un repositorio sin salir del editor.
Resumen
Worktree agrega un icono a la barra de actividades de VS Code con una vista que lista todos
los worktrees del repositorio abierto:
Ordenados por actividad: del commit más reciente al más antiguo, con la rama (o el
commit si está detached), la ruta y la fecha del último commit. Al pasar el cursor sobre la fecha relativa se muestra la fecha y hora completas.
Worktree actual destacado: el worktree de la ventana en la que estás se marca con la
etiqueta current; el principal lleva la etiqueta principal.
Abrir: doble clic sobre un worktree, o clic secundario → Abrir, lo abre en una
ventana nueva de VS Code.
Copiar ruta: copia la ruta del worktree al portapapeles. Las rutas dentro de tu home se
muestran abreviadas con ~.
Descripción: cada tarjeta permite agregar o editar una nota de texto libre (hasta 500
caracteres). Para editarla, usa el botón de editar o haz doble clic sobre el texto (sin abrir el worktree). Se guarda sola al salir del campo (o con Alt+Enter, ⌘+Enter en Mac) y la comparten todas las ventanas del repositorio.
Crear worktree: formulario con rama, base y ruta opcionales.
Actualización en vivo: la lista se mantiene al día mediante SSE (Server-Sent Events);
cuando cambian los datos de git la vista se refresca sola.
Configuración: rama base para los worktrees nuevos, carpeta base donde se crean
(por defecto .worktree/, relativa a la raíz del proyecto) y estilo compacto.
Estilo compacto: desde la configuración (⚙️) la lista pasa de tarjetas a filas densas:
rama, current/principal, ruta con ~, tiempo relativo (al pasar el cursor, la fecha
completa), descripción resumida en una línea y las acciones de copiar y editar la descripción.
Doble clic, Enter y el menú Abrir funcionan igual. Se guarda sola y se
refleja en las demás ventanas del repositorio.
Capturas
Extensión en VS Code
Worktree current
Configuración
Menú Abrir
Copiar ruta
Estados y rutas con ~
Descripción por worktree
Estilo compacto
Crear worktree
Worktree creado
La configuración y las descripciones se guardan automáticamente en .git/_worktree_configs.
Instalación
Descarga el archivo .vsix de la última versión en
Releases.
Instálalo en VS Code, con Extensions → ⋯ → Install from VSIX… o desde la terminal:
code --install-extension worktree-<versión>.vsix
Abre un repositorio git y pulsa el icono de Worktree en la barra de actividades.
Seguridad
Qué archivos crea, qué comandos ejecuta y cómo reportar una vulnerabilidad: SECURITY.md.
Contribuir
Cómo ejecutar la extensión en desarrollo y publicar una versión: CONTRIBUTING.md.
