Git Easy View

Extensión de Visual Studio Code para gestionar ramas Git de forma rápida y visual desde el panel de Source Control.

Git Easy View añade una vista al panel de Git (barra lateral izquierda) que te permite:

Ver todas las ramas locales organizadas por tipo (feature/, hotfix/, bugfix/, release/, etc.).
Ver cuántos commits tienes:
- Pendientes de hacer pull desde el remoto (R).
- Pendientes de hacer push al remoto (L).
Hacer checkout, crear ramas nuevas, actualizar desde remoto, hacer push, mergear y borrar ramas con un solo clic.

Características principales

✅ Vista propia en el panel de Git (Git branch) dentro de SCM.
📂 Ramas agrupadas por prefijo:
- feature/login → carpeta feature → rama login.
- hotfix/1234 → carpeta hotfix → rama 1234.
- Ramas sin / (como main, develop) se muestran en la raíz.
🔢 Indicadores de estado por rama:
- XR → la rama está X commits por detrás del remoto (hace falta pull).
- YL → la rama está Y commits por delante del remoto (hace falta push).
- Current → rama actual.
🔁 Auto-refresco cuando cambia el estado de Git y botón manual para forzar actualización (hace git fetch + refresco).

Acciones disponibles por rama

Cada rama muestra una fila con iconos de acción a la derecha (solo en ramas, no en las carpetas):

Acción	Qué hace	Cuándo se muestra
Checkout	Cambia a esa rama (`git checkout`)	Siempre
Merge into current	Hace merge de esa rama en la rama actual	Siempre
Create branch from	Crea una nueva rama basada en la rama seleccionada, con prefijos típicos	Siempre
Update from remote	Hace `git pull` de la rama (previo `checkout` si es necesario)	Solo si la rama tiene `R > 0`
Push branch	Hace `git push` de la rama (previo `checkout` si es necesario)	Solo si la rama tiene `L > 0`
Delete branch	Elimina la rama local (no permite eliminar la rama actual)	Siempre

Creación de nuevas ramas con prefijos

Al pulsar en Create branch from sobre una rama:

Aparece un selector con prefijos comunes:
- feature
- hotfix
- bugfix
- release
- none (sin prefijo)
Después se pide el nombre de la nueva rama (por ejemplo test).
Se crea la rama:
- Si eliges feature → feature/test.
- Si eliges none → test.

La rama nueva se crea a partir de la rama sobre la que pulsaste y se hace checkout automáticamente.

Indicadores R y L

En la descripción de cada rama se muestran, cuando procede:

XR → la rama está X commits detrás del remoto (behind), es decir: hay cambios remotos pendientes de aplicar → deberías hacer pull.
YL → la rama está Y commits por delante del remoto (ahead), es decir: tienes commits locales sin subir → deberías hacer push.

Ejemplos:

develop 3R · Current → la rama actual develop tiene 3 commits pendientes en remoto.
feature/login 2L → feature/login tiene 2 commits locales sin push.
hotfix/123 1R · 1L · Current → combinación de ambos casos.

Instalación

Opción 1: Instalar desde un archivo `.vsix` (para usar en otros equipos)

Empaqueta la extensión (en tu máquina de desarrollo):

Instala la herramienta de empaquetado:
```
npm install -g @vscode/vsce
```
Compila la extensión:
```
npm run compile
# o
pnpm run compile
```
Genera el paquete:
```
vsce package
```

Se generará un archivo similar a:

git-easy-view-0.0.1.vsix

En el otro equipo, abre VS Code y:

Ve a la pestaña Extensions.
Pulsa en el menú ... (arriba a la derecha).
Elige Install from VSIX….
Selecciona tu archivo git-easy-view-0.0.1.vsix.

O desde terminal:

code --install-extension git-easy-view-0.0.1.vsix

Opción 2: Ejecutar desde código fuente (modo desarrollo)

Clona el repositorio:

git clone <url-del-repo>
cd git-easy-view

Instala dependencias:
```
npm install
# o
pnpm install
```
Compila:
```
npm run compile
```
Inicia VS Code en modo extensión:
- Abre el proyecto en VS Code.
- Pulsa F5 para lanzar una Extension Development Host.
- En esa nueva ventana podrás probar la extensión.

Uso

Abre un proyecto que tenga un repositorio Git inicializado.
Ve al panel de Source Control / SCM (icono de Git en la barra lateral izquierda).
Dentro del panel, busca la vista llamada Git branch (creada por la extensión).

Desde ahí podrás:

Ver las ramas organizadas (raíz + carpetas feature, hotfix, etc.).
Ver los contadores R y L.
Usar los iconos de acción para trabajar con ramas sin salir del panel.

Requisitos

Visual Studio Code: ^1.106.0
Tener el repositorio Git inicializado en la carpeta del proyecto.
Extensión oficial de Git de VS Code habilitada (la que viene por defecto).

Scripts de desarrollo

Desde la raíz del proyecto:

npm run compile → compila TypeScript a out/.
npm run watch → compilación en modo watch.
npm run lint → ejecuta ESLint.
npm run test → tests con el runner de VS Code.

Roadmap (ideas futuras)

Filtro/búsqueda de ramas por nombre.
Mostrar también el remoto asociado (origin/main, origin/develop, etc.).
Configuración para personalizar prefijos (feature, hotfix, …).
Soporte para múltiples repositorios abiertos en el workspace.

¡Disfruta usando Git Easy View para tener tus ramas siempre bajo control sin salir del panel de Git! 😄

git-easy-view

Jesus Periago Rodríguez