El panel de Git

Pulsa Cmd+Shift+G. El panel abre el repositorio al que está vinculado el proyecto; consulta el directorio del proyecto para saber cómo lo elige Zshell.

Cada acción es un comando de Git que Zshell ejecuta por ti. La salida se muestra cuando hay algo más que decir que «hecho». Nada se reescribe, se combina con squash ni se envía de forma forzada salvo que lo hayas pedido.

La barra de herramientas de GitCopiar enlace

Zshell puede mostrar una barra compacta debajo de la pestaña activa. Dentro de un repositorio muestra la rama actual y el total de líneas añadidas y eliminadas; un árbol sin modificaciones muestra Sin cambios en verde. Los archivos sin seguimiento cuentan como líneas añadidas.

• Haz clic en la rama para buscar y cambiar entre ramas locales. La rama predeterminada del repositorio aparece marcada en la lista.
• Haz clic en los contadores de cambios para abrir el panel de Git.
• Fuera de un repositorio, el modo Mostrar siempre deja un botón Sin repositorio Git que abre el estado de inicialización del panel.

Elige Ocultar, Automático o Mostrar siempre en Ajustes → General, o configura toolbar.visibility. El valor predeterminado es Ocultar. También puedes ocultar una barra visible desde su menú contextual.

Archivos modificadosCopiar enlace

Los archivos se agrupan en conflictos, cambios preparados y cambios sin preparar. Pasa el puntero sobre una fila para ver sus botones o usa el menú contextual:

Descartar todos los cambios está en la cabecera del panel y pide confirmación: es la única acción de este panel que no puedes deshacer con otro comando de Git.

Los archivos en conflicto muestran Marcar como resuelto (preparar) en lugar de un botón de preparación normal, para que resolverlos sea un paso deliberado y no un efecto secundario.

El botón de embudo de la cabecera filtra la lista por nombre de archivo, la forma más rápida de recorrer un cambio grande.

Leer diferenciasCopiar enlace

Haz clic en cualquier archivo modificado para abrir sus diferencias en un panel junto al terminal, sin superponerlas. Desde el menú contextual también puedes Abrir archivo (el archivo en sí, editable) o Abrir archivo al lado.

Las diferencias grandes siguen respondiendo con fluidez. Un conjunto de cambios de mil archivos se abre tan rápido como uno de una línea y se desplaza sin tirones.

Los controles sobre la vista de diferencias recuerdan dos preferencias globales:

• Unificado / Dividido cambia entre una columna y una disposición en paralelo.
• Revisar / Editar aparece para un archivo sin preparar del árbol de trabajo actual. Edita directamente el lado nuevo y guarda con Cmd+S; al cerrar un archivo con cambios sin guardar se aplica el mismo tratamiento que en el editor normal.

Las diferencias preparadas y las de commits históricos siguen siendo de solo lectura porque son instantáneas, no archivos que Zshell pueda escribir con seguridad. Cambiar una vista a Editar o Dividido actualiza la preferencia de otras vistas abiertas, sin convertir en editable una que no cumpla los requisitos.

Crear commitsCopiar enlace

Escribe un mensaje y usa el botón de commit o elige una opción de su menú:

• Confirmar preparados: crea un commit exactamente con lo que preparaste.
• Preparar todo y confirmar: prepara todos los archivos con seguimiento y después crea el commit.
• Modificar último commit: incorpora los cambios preparados al commit anterior.
• Preparar todo y modificar.

Los commits recientes aparecen debajo, con Copiar hash del commit y Copiar mensaje del commit en sus menús contextuales.

RamasCopiar enlace

El nombre de la rama en la cabecera es un menú: elige otra rama para cambiar a ella o Crear nueva rama… para crear una desde tu posición actual.

Árboles de trabajoCopiar enlace

El panel de Git enumera todos los árboles de trabajo del repositorio, con su rama y la ruta de la copia de trabajo. La copia activa aparece marcada como Actual. Haz clic en un árbol de trabajo para abrir una pestaña de terminal nueva en ese directorio; cada copia conserva así su propio contexto de shell dentro del mismo proyecto. Las listas largas se desplazan dentro de su propia área delimitada; la cabecera de sección, los controles de commit y la lista de archivos modificados permanecen en su sitio. Haz clic en la cabecera de árboles de trabajo para contraerla o expandirla.

Los árboles de trabajo con HEAD separado muestran HEAD separado en lugar del nombre de una rama. Los repositorios bare también se enumeran para que la lista sea completa, pero no tienen directorio de trabajo y no pueden abrirse en una pestaña de terminal.

Sesiones de worktreeCopiar enlace

En un terminal de un repositorio Git local, elige Terminal → Nueva sesión en un worktree… o pulsa Cmd+Opt+T. Los menús contextuales de la pestaña y del botón + ofrecen la misma acción. Elige una rama local nueva o existente y un directorio que aún no exista. Las ramas nuevas parten de la rama predeterminada del repositorio; HEAD actual es una elección explícita. Las ramas existentes conservan su commit actual. El directorio sugerido está junto al checkout de origen.

Los paneles divididos heredan la asociación con el worktree, y la disposición guardada la restaura. Al cerrar una sesión asociada, puedes elegir Conservar worktree, Eliminar worktree o Cancelar. Solo se permite eliminarlo sin archivos modificados, no seguidos o ignorados, commits fuera de la referencia registrada, bloqueo u otras sesiones abiertas que usen el checkout. La rama Git siempre se conserva.

Un terminal externo puede crear y cerrar sesiones con zshell +session. Usa en --project un ID devuelto por projects; dentro de Zshell se usa automáticamente el proyecto del terminal que invoca el comando. Las sesiones se crean en segundo plano salvo con --focus. --base HEAD o --base REF elige otra referencia y --worktree NEW_DIR define el directorio. --connection FILE selecciona una instancia en ejecución cuando sea necesario. Cerrar conserva el worktree salvo con --remove-worktree explícito; check informa de si la limpieza es segura.

zshell +session projects
zshell +session new --project PROJECT_ID --cwd /path/to/repo --branch feat/task
zshell +session list --project PROJECT_ID
zshell +session check --project PROJECT_ID --session SESSION_ID
zshell +session close --project PROJECT_ID --session SESSION_ID --remove-worktree

RemotosCopiar enlace

El menú ⋯ contiene todas las acciones que se comunican con un remoto:

Los indicadores junto a la rama muestran cuántos commits estás ↓ por detrás y ↑ por delante del upstream.

El mismo menú contiene Copiar rutas modificadas, Copiar ruta del repositorio y Mostrar repositorio en Finder.

Todavía no es un repositorioCopiar enlace

Si el directorio del proyecto no contiene un repositorio, el panel ofrece Inicializar repositorio, que ejecuta git init en esa carpeta. Hasta entonces, no estorba.

Revisar turnos de agentesCopiar enlace

Pulsa Revisar cambios… en el panel Git.

• Último turno compara las instantáneas inicial y final del agente elegido e incluye todas las ediciones de ese intervalo, sin importar el autor.
• Sin confirmar compara HEAD con el árbol de trabajo, incluidos archivos preparados y sin seguimiento.
• Rama completa compara el ancestro común con la rama base elegida y el árbol de trabajo, incluidos commits y archivos sin confirmar.

Elige un archivo y un bloque. En Último turno, Conservar bloque registra la revisión; Revertir bloque lo revierte en el árbol de trabajo. Ninguna acción modifica el índice Git. La instantánea original y las decisiones siguen visibles.

Se rechaza la reversión si cambió el archivo o HEAD, la ruta no es segura, hay un agente activo o los turnos se solapan. Los cambios binarios o solo de permisos son de solo lectura. Los archivos de más de 5 MiB no están disponibles; tampoco las instantáneas con más de 2048 rutas modificadas, 25 MiB capturados o que superen el tiempo límite.

Las instantáneas duran la sesión actual de la aplicación. Se necesitan eventos fiables de inicio y fin. Pi, OpenCode y Grok tienen integraciones nativas. Los prompts protegidos capturan el inicio, pero también necesitan un evento de finalización. Sin él, no habrá una instantánea completada.