GitTree manual de escritorio

Utilice GitTree para su trabajo diario

GitTree es un cliente Git de escritorio para macOS, Windows y Linux. Inicie sesión y todas las tareas locales de Git estarán en el plan gratuito: abrir, clonar, confirmar, bifurcar, fusionar, rebase, guardar y deshacer. GitTree Pro agrega integraciones de alojamiento, ejecuciones de CI/CD, redacción de IA y Nour, el asistente de IA.

Instale GitTree en macOS

GitTree para Mac es una aplicación universal para Apple Silicon e Intel Macs en macOS 13 o posterior, firmada y certificada ante notario por Apple. Primero instale Git, abra el .dmg, arrastre GitTree a Aplicaciones e inícielo.

Instale GitTree en Windows

GitTree para Windows es un instalador de 64 bits para Windows 10 (22H2) y Windows 11. Primero instale Git for Windows, elija Microsoft Store o el EXE directo e inicie GitTree desde el menú Inicio.

Instale GitTree en Linux

GitTree para Linux viene como .deb para Ubuntu 22.04 o posterior y Debian 12 o posterior, y como AppImage portátil, ambos para x86_64 de 64 bits. Primero instale Git 2.39 o una versión más reciente, luego instale .deb con apt o ejecute AppImage.

Encuentra Git y configura tu identidad de confirmación

GitTree ejecuta el Git instalado en tu computadora y nunca incluye uno. Necesita Git 2.39 o más reciente, y un nombre y correo electrónico para sus confirmaciones (user.name y user.email), que solicita la primera vez que una confirmación los necesita.

Encuentra tu camino alrededor de GitTree

Una pestaña de repositorio tiene seis partes: la barra de pestañas, la barra de herramientas, la barra lateral, el gráfico de confirmación, el inspector y la barra de estado. Esta página muestra dónde está cada uno y qué haces allí.

Crea tu primer compromiso

Una confirmación guarda una instantánea de los cambios que realizó, con un mensaje que explica el motivo. En GitTree colocas un archivo en el panel de cambios, escribes un resumen y presionas Commit: la nueva confirmación aparece en la parte superior del gráfico.

Utilice Git local de forma gratuita y comprenda Pro

Todas las funciones locales de Git en GitTree son gratuitas para todos los que inician sesión con una cuenta de GitTree. GitTree Pro agrega Nour, las integraciones de alojamiento y redacción de IA; puedes probarlos con una prueba gratuita que comienza solo cuando tú la solicitas.

Abrir un repositorio existente

Elige la carpeta de un repositorio Git que ya está en tu computadora y GitTree la abre en su propia pestaña, con su gráfico de confirmación, ramas y cambios. No se carga nada: el repositorio permanece en tu computadora.

Clonar un repositorio

La clonación copia un repositorio de GitHub, GitLab, Bitbucket, Azure DevOps o cualquier servidor Git a tu computadora, con su historial. En GitTree pegas la URL, eliges dónde va y presionas Clone; se abre en una nueva pestaña cuando termina.

Crear un repositorio

La inicialización convierte una carpeta en un repositorio Git, igual que git init. En GitTree eliges la carpeta y la rama inicial, opcionalmente agregas un .gitignore y una licencia, y presionas Initialize.

Utilice repositorios recientes y favoritos

La nueva pestaña enumera los repositorios que abrió en Recent y los que destacó en Favourites. Seleccione uno para abrirlo en una pestaña. Las listas permanecen en esta computadora.

Buscar repositorios en el disco

Scan for Repositories… busca en una carpeta que elijas y enumera cada repositorio de Git hasta tres carpetas de profundidad. No se abre nada hasta que tú elijas; puede abrir uno o agregarlo a un espacio de trabajo.

Revisar la confianza del repositorio

Algunos repositorios contienen configuraciones o enlaces de Git que ejecutan programas en su computadora cuando Git funciona en ellos. Antes de que eso pueda suceder, GitTree muestra Trust this repository? exactamente lo que encontró y le permite confiar en él o abrirlo en Restricted mode.

Abrir un repositorio desnudo

Un repositorio simple tiene historial pero no archivos que funcionen, como los que los servidores guardan para que otros los envíen (git init --bare, git clone --bare). GitTree lo abre para mostrar el gráfico, las ramas y las etiquetas, marca su pestaña bare y desactiva las acciones que necesitan archivos de trabajo.

Administrar pestañas del repositorio

Cada repositorio se abre en su propia pestaña en la parte superior de la ventana. Las pestañas muestran el estado del repositorio, como cambios no confirmados o una rebase en progreso, y puedes cambiar entre ellas desde el teclado.

Leer el gráfico de confirmación

El gráfico de confirmación muestra el historial del repositorio como filas, las más nuevas primero, con carriles que se dividen donde comienzan las ramas y se unen donde se fusionan. Las etiquetas en las filas muestran ramas y etiquetas; una marca de verificación muestra la sucursal en la que se encuentra.

Encuentra un compromiso

Presione Ctrl+F (⌘F en Mac) en el gráfico y escriba parte de un mensaje de confirmación, un autor, un SHA, una rama o una etiqueta. GitTree resalta las coincidencias y se mueve entre ellas; Filter Graph limita el historial mismo.

Inspeccionar una confirmación

Seleccione una confirmación en el gráfico y el inspector de la derecha mostrará todo sobre ella: el mensaje, el SHA completo, sus padres, quién lo escribió y confirmó y los archivos que cambió. Seleccione un archivo para ver su diferencia.

Enfocar y filtrar el gráfico.

En un repositorio ocupado, Focus on Current Branch muestra solo su rama, su fuente ascendente y su base, con cuántas confirmaciones tiene desde la base. Filter Graph… mantiene las confirmaciones de un autor, un rango de fechas o una ruta. El filtrado nunca elimina el historial; Clear Graph Filter recupera cada fila.

Personalizar columnas de gráficos

El gráfico muestra las etiquetas de las sucursales, los carriles y el mensaje por defecto. El menú Graph columns agrega columnas Author, Date y SHA y cambia a filas compactas; puedes cambiar el tamaño de cada columna y ocultar los paneles laterales.

Comparar confirmaciones y actuar sobre una selección

Seleccione dos confirmaciones con Ctrl (⌘ en un Mac) presionado y elija Compare These Two Commits para ver todos los archivos que difieren. Una selección de varias confirmaciones tiene sus propias acciones: copiar los SHA, seleccionar, revertir, aplastar o crear un parche.

Utilice arrastrar y soltar gráficos

Arrastre una etiqueta de rama a otra rama en el gráfico y GitTree ofrece lo que ambas pueden hacer: Fast-forward, Merge o Rebase. No pasa nada hasta que tú eliges; Se aplican la confirmación habitual y Deshacer.

Revisar los cambios de trabajo

El panel Working Changes es el git status de GitTree: enumera todos los archivos que cambiaste desde la última confirmación, divididos en Unstaged Files y Staged Files, y muestra la diferencia del archivo que seleccionas.

Archivos de escenario, trozos y líneas seleccionadas.

Una confirmación contiene solo lo que usted presenta. En GitTree preparas un archivo completo, una parte del mismo o solo las líneas que seleccionas en la diferencia, y el resto de tus ediciones permanecen en la carpeta de trabajo para una confirmación posterior.

Escribe un mensaje de confirmación y confirma

El formulario de confirmación se encuentra debajo de sus archivos preparados: una línea Summary, una Description opcional y Commit Options para coautores, cierre de sesión, enlaces y empuje posterior. GitTree señala errores comunes en los mensajes antes de cometerlos.

Modificar el último compromiso

La modificación reemplaza la última confirmación con una nueva que tiene su mensaje corregido y cualquier cambio que realice ahora, como git commit --amend. En GitTree es el interruptor Amend Previous Commit en el formulario de confirmación.

Descartar cambios y limpiar archivos sin seguimiento

Al descartarlo, los archivos vuelven a su último estado confirmado o preparado, como git restore; La limpieza elimina archivos que Git no rastrea, como git clean. GitTree guarda primero una instantánea de recuperación, para que Undo pueda recuperarla.

Elija y use una vista diferencial

Cada diferencia en GitTree se puede mostrar como Hunk, Inline o Split (uno al lado del otro). Resalte las palabras modificadas, ajuste líneas largas, ignore los cambios de espacios en blanco, obtenga una vista previa de Markdown y salte de un cambio al siguiente.

Ignorar archivos de GitTree

Los archivos que nunca desea confirmar, como el resultado de la compilación o la configuración local, pertenecen a .gitignore. Haga clic derecho en un archivo nuevo en sus cambios de trabajo y elija qué ignorar o edite .gitignore directamente con Edit .gitignore….

Crear y aplicar parches

Un parche es un archivo que transporta cambios de un repositorio a otro. GitTree guarda los cambios de un archivo o una o más confirmaciones como un parche y aplica un parche a su árbol de trabajo, por etapas o como confirmaciones en la rama actual.

Revisar imágenes y cambios binarios.

Las diferencias de texto no pueden mostrar una imagen. Cuando cambia una imagen PNG, JPEG, GIF, WebP u otra imagen, GitTree compara las imágenes de antes y después: Side by side, Swipe o Onion skin. Otros archivos binarios muestran sus tamaños.

Administrar indicadores de índice de archivos rastreados

A veces cambias un archivo rastreado solo en tu computadora, como una configuración local. Dos indicadores de Git ocultan dichos cambios: Skip Worktree… conserva su copia y deja de mostrar sus cambios; Assume Unchanged… es una aceleración que impide que Git revise el archivo. Ninguna de las dos es una forma de ignorar un archivo.

Crear y cambiar de rama

Una sucursal es un nombre móvil para una línea de trabajo. En GitTree, Branch en la barra de herramientas crea uno en la confirmación en la que te encuentras; haga clic derecho en cualquier confirmación para crear una allí. Haga doble clic en la etiqueta de una rama para cambiar a ella.

Cambiar nombre y eliminar ramas

Haga clic derecho en la etiqueta de una sucursal para Rename y Delete. Al eliminar una sucursal local se guarda primero su última confirmación en refs/ogt/trash, por lo que Undo la recupera; eliminar en el control remoto es una opción separada y con un nombre claro.

Crear y administrar etiquetas

Una etiqueta es un nombre fijo para una confirmación, normalmente una versión como v2.2.0. Haga clic derecho en una confirmación, elija Tag Here y luego una etiqueta ligera o anotada. Las etiquetas no se envían con sus confirmaciones: envíe cada una con Push Tag.

Establecer seguimiento y publicar una sucursal

Una nueva rama existe solo en su computadora hasta que la presiona. El primer Push pregunta a qué control remoto enviarlo y, a partir de ahí, la rama rastrea esa rama remota (es ascendente), como git push -u. Set Upstream… cambia lo que rastrea.

Comparar ramas y etiquetas

Compare References… compara dos ramas, etiquetas, ramas remotas o confirmaciones por nombre. Muestra cuántas confirmaciones hay una delante y detrás de la otra, y los archivos que difieren: ya sea cada diferencia (git diff A B) o solo lo que cambió el nuevo lado desde que se dividieron (A...B, lo que muestra una solicitud de extracción).

Utilice acciones de Gitflow

Gitflow es un modelo de ramificación con una rama de producción, una rama de desarrollo y ramas de funciones, lanzamientos y revisiones. La sección Gitflow de GitTree la inicializa e inicia y finaliza esas ramas, fusionándolas, etiquetándolas y eliminándolas por usted.

Reconocer y dejar CABEZA separada

Consultar una confirmación o una etiqueta en lugar de una rama te sitúa en un detached HEAD: no estás en ninguna rama. Puede mirar a su alrededor e incluso confirmar, pero las nuevas confirmaciones no pertenecen a ninguna rama. Crea una sucursal para conservarlos o consulta una sucursal para regresar.

Traer, tirar y empujar

Fetch descarga las novedades de tus controles remotos sin cambiar tu trabajo. Pull incorpora el upstream de tu sucursal. Push envía tus confirmaciones al control remoto. Los tres están en la barra de herramientas, con sus opciones en los menús de flechas al lado de ellos.

Agregar y editar controles remotos

Un control remoto es una copia con nombre del repositorio en otro lugar, como origin en GitHub. La sección Remote del panel izquierdo los enumera; Add Remote… agrega uno y, al hacer clic con el botón derecho en un control remoto, lo edita, lo recupera, lo elimina o lo elimina.

Elija credenciales remotas

GitTree ejecuta su propio Git, así que obtenga, extraiga y presione el inicio de sesión como lo hace Git en su computadora: a través de HTTPS a través de su asistente de credenciales, a través de SSH con su clave o agente SSH. Las contraseñas y los tokens permanecen en el llavero de su sistema, nunca en los archivos de GitTree.

Configurar la recuperación automática

La recuperación automática mantiene actualizadas las ramas remotas en su gráfico sin que usted presione Fetch All. Configure Auto-fetch interval en minutos para cada repositorio abierto, anúlelo para un repositorio y reciba una notificación en el escritorio cuando lleguen nuevas confirmaciones.

Utilice un empuje forzado con arrendamiento

Después de modificar, cambiar la base o restablecer las confirmaciones que ya envió, se rechaza una inserción normal. Force Push (With Lease)… reemplaza la rama remota con la tuya, pero solo si todavía está donde la recuperaste por última vez, como git push --force-with-lease. GitTree nunca fuerza-empuja de ninguna otra manera.

Trabajar con historial de repositorio limitado

Un clon superficial descarga sólo las últimas confirmaciones; un clon sin blobless descarga el contenido del archivo sólo cuando es necesario. Ambos crean repositorios enormes que se pueden clonar rápidamente. En un clon superficial, el gráfico muestra dónde termina el historial y Fetch More History o Fetch Full History traen el resto.

Fusionar ramas

La fusión trae las confirmaciones de otra rama a la rama en la que se encuentra, como git merge. Haga clic derecho en la otra rama y elija Merge … into …: GitTree comprueba primero si hay conflictos y le permite elegir cómo se registra la combinación.

Rebase una rama

La rebase reproduce las confirmaciones de su rama encima de otra rama, por lo que el historial permanece en línea recta, como git rebase. Las confirmaciones obtienen nuevos identificadores; GitTree mantiene la rama anterior bajo refs/ogt/trash y Undo la recupera.

Resolver conflictos de fusión

Un conflicto ocurre cuando ambas ramas cambiaron las mismas líneas. El solucionador de GitTree muestra las dos versiones una al lado de la otra, A y B: marque las líneas para mantener en cada conflicto, marque Output, luego Save y continúe con la fusión, rebase o selección.

Seleccionar y revertir confirmaciones

Cherry-Pick Commit copia los cambios de una confirmación en su rama actual como una nueva confirmación, como git cherry-pick. Revert Commit agrega una nueva confirmación que deshace una, como git revert: la forma segura de recuperar algo ya enviado.

Continuar, omitir o cancelar una operación

Una fusión, un cambio de base, una selección selectiva o una reversión pueden detenerse a mitad de camino, generalmente en un conflicto. Un banner encima del gráfico nombra la operación y su paso, y ofrece Resolve, Continue, Skip (rebase) y Abort…. Al cancelar se guarda lo que se elimina primero, por lo que Undo lo devuelve.

Reutilizar resoluciones de conflictos grabadas

Con Reuse recorded resolutions (rerere) activado, Git recuerda cómo resolvió un conflicto y escribe la misma resolución cuando ese conflicto regresa, durante un cambio de base repetido, por ejemplo. GitTree te indica cuándo sucedió y te permite revisarlo antes de marcar el archivo como resuelto.

Editar historial con una rebase interactiva

Una rebase interactiva reescribe las confirmaciones encima de una elegida: mantener, reformular, editar, aplastar, arreglar o soltar cada una y arrastrarlas a un nuevo orden, como git rebase -i. Para un solo cambio, Edit History en el menú de confirmación lo hace en un solo paso.

Compromisos de calabaza

Squashing combina varias confirmaciones en una, como fixup o squash en git rebase -i. En GitTree cada calabaza abre primero el cuadro de diálogo Squash: muestra las confirmaciones que se pliegan, el resultado, el mensaje y quién recibe el crédito, y nada cambia hasta que usted confirma. Su trabajo no comprometido nunca se modifica y Undo devuelve las confirmaciones.

Cambiar confirmaciones locales seleccionadas

Para un cambio rápido en el historial, no necesita todo el editor de rebase interactivo. El menú Edit History de una confirmación edita su mensaje, lo suelta o lo mueve hacia arriba o hacia abajo; Al seleccionar varias confirmaciones se abre el cuadro de diálogo Squash. GitTree reescribe las confirmaciones anteriores y mantiene la rama anterior, por lo que Undo la devuelve.

Restablecer una rama a una confirmación

Restablecer mueve su rama actual a otra confirmación, como git reset. Soft mantiene todos los cambios preparados, Mixed los mantiene en su carpeta de trabajo, Hard los descarta. GitTree guarda todo en refs/ogt/trash primero, por lo que incluso un restablecimiento completo se puede deshacer.

Deshacer y rehacer

GitTree registra tus operaciones de Git para que Undo en la barra de herramientas pueda recuperar la última: una confirmación, fusión, rebase, reinicio, descarte, limpieza, rama o etiqueta eliminada. Redo lo vuelve a hacer. Los pasos destructivos guardan una instantánea de recuperación en refs/ogt/trash antes de ejecutarse.

Encuentra consejos sobre sucursales anteriores

El reflog registra hacia dónde apuntaba una rama o HEAD, cada vez que se movía: confirmaciones, retiradas, restablecimientos, rebases. View Reflog… enumera esas entradas; elija uno para mostrar su confirmación en el gráfico o Restore as Branch.

Historial de archivos y culpa

History enumera todas las confirmaciones que cambiaron un archivo, después de cambios de nombre, como git log --follow. Blame muestra, para cada línea, la confirmación y el autor que la cambió por última vez, como git blame. Ambas son vistas del espacio de trabajo de archivos.

Utilice el flujo de trabajo de bisección

Bisect encuentra la primera confirmación que introdujo un problema dividiendo a la mitad el historial entre una confirmación que lo tiene y otra que no, como git bisect. Seleccione las dos confirmaciones, pruebe la confirmación GitTree, márquela Good o Bad y repita hasta que nombre el First bad commit.

Exportar un archivo

Export Archive… escribe los archivos de una confirmación, rama o etiqueta como .zip o .tar.gz, sin la carpeta .git, como git archive. Es la forma más rápida de entregarle a alguien la fuente de un comunicado.

Utilice herramientas de creación y mantenimiento del repositorio

Repository Maintenance… muestra el tamaño de la base de datos de objetos y ejecuta tareas que la verifican o agilizan el historial y el estado. Merge Author Identities… escribe .mailmap líneas para que una persona con varios nombres o correos electrónicos se muestre como un solo autor.

Organizar espacios de trabajo

Un espacio de trabajo es un conjunto de repositorios con nombre que se abre como una unidad, como "Cliente A" o "Móvil". Su panel muestra la rama de cada repositorio, el estado de sincronización y los cambios, además de las solicitudes de extracción y las ejecuciones de CI/CD en ellos.

Administrar repositorios guardados

Cada espacio de trabajo mantiene una lista de Saved repositories: cada repositorio que abre, clona, crea o agrega desde un escaneo mientras es el espacio de trabajo actual se guarda allí y permanece después de que se cierra su pestaña. Ábrelos de la lista, todos a la vez, o elimina uno; su carpeta nunca se toca.

Cambios de alijo

Un alijo deja a un lado los cambios no confirmados y le brinda una carpeta de trabajo limpia, como git stash, para que pueda cambiar de tarea y recuperar los cambios más tarde. Stash en la barra de herramientas guarda todo; La pestaña Stash del panel de cambios elige exactamente qué.

Trabajar en varias ramas con árboles de trabajo.

Un árbol de trabajo es una segunda carpeta de trabajo para el mismo repositorio, con su propia rama desprotegida, como git worktree add. Revise una solicitud de extracción, ejecute una compilación larga o deje que un agente de codificación trabaje en uno, sin guardar nada en el otro.

Administrar submódulos

Un submódulo es otro repositorio anclado dentro del suyo en una confirmación específica. GitTree los enumera con su estado (no inicializado, actualizado, confirmación diferente, en conflicto) y los agrega, inicializa, actualiza, abre, edita y elimina.

Utilice controles Git LFS

Git LFS almacena archivos grandes, como imágenes, vídeos o modelos, fuera del repositorio y mantiene pequeños archivos de puntero en su lugar. Git LFS… lo configura, rastrea patrones, descarga contenido, bloquea archivos y elimina contenido antiguo.

Explorar y editar archivos de proyecto

La sección Files del panel izquierdo muestra las carpetas de su proyecto, marcando las que contienen cambios. Abra un archivo para leerlo o editarlo en una pestaña al lado de la pestaña Graph y cámbielo entre File, Changes, Blame y History.

Abrir y editar archivos

Un archivo que abre en GitTree obtiene su propia pestaña junto a la pestaña fijada Graph. Un archivo de una confirmación es de sólo lectura; Edit in Working Directory abre la copia en tu proyecto para editar y Save. Si el archivo cambia en el disco mientras tanto, GitTree no guarda nada y le permite elegir.

Volver al gráfico de confirmación

Diferencias, archivos, culpas, historial, comparaciones, canalizaciones y solicitudes de extracción se abren sobre el gráfico. Esc cierra el superior y regresa a la vista que lo abrió; Back to Graph se los quita todos a la vez. Los archivos abiertos solo se ocultan: sus pestañas permanecen al lado de la pestaña Graph.

Utilice el terminal incorporado

Terminal en la barra de herramientas abre un shell en la raíz del repositorio en el cajón debajo del gráfico. Ejecute cualquier comando allí, incluido Git: el gráfico y sus cambios se actualizan a medida que avanza. Cada pestaña del repositorio mantiene sus propios terminales.

Configurar herramientas externas

Preferencias › External Tools elige las aperturas Editor, Diff tool y Merge tool GitTree desde los menús de archivos y la vista de conflictos. Automatic utiliza la primera instalación de Visual Studio Code, Cursor y Antigravity; Custom… ejecuta cualquier programa con los argumentos que usted proporciona.

Crear y ejecutar acciones personalizadas

Los comandos personalizados ejecutan sus propios programas en un repositorio desde el botón Custom actions y desde los menús de confirmación, rama y archivo. Cada argumento se pasa exactamente como está escrito, no interviene ningún shell y la primera ejecución de un comando muestra exactamente qué se ejecutará antes que él.

Buscar acciones con la paleta de comandos

La paleta de comandos ejecuta cualquier comando GitTree escribiendo parte de su nombre y también salta a ramas, confirmaciones, archivos y repositorios abiertos. Presione Ctrl+Shift+P (⌘⇧P en un Mac), escriba y presione Entrar.

Atajos de teclado

La mayoría de los comandos GitTree tienen un atajo. Presione Ctrl+/ (⌘/ en un Mac) para ver la lista completa dentro de la aplicación, filtrada a medida que escribe; Customize… no cambia ninguno de ellos. Las tablas siguientes enumeran los valores predeterminados.

Inspeccionar actividad y notificaciones.

El Activity Log enumera cada comando git GitTree ejecutado, con su resultado, cuánto tiempo tomó y si falló; Se eliminan los tokens, contraseñas y credenciales de las URL. Notifications mantiene los mensajes mostrados en esta sesión y Preferencias › Notifications decide qué ventanas emergentes y si su sistema también las muestra.

Utilice la guía de funciones de la aplicación

El Feature Guide enumera todo lo que GitTree puede hacer, dónde encontrarlo y sus accesos directos, agrupado por área, con un cuadro de búsqueda. Show me te lleva a la función en el repositorio que tienes abierto; las funciones que necesitan un repositorio, Pro o una cuenta conectada lo dicen.

Conectar GitHub

Conectar GitHub permite a GitTree enumerar sus repositorios, solicitudes de extracción, problemas y comprobaciones. Inicia sesión con tu navegador (recomendado: apruebas GitTree en la propia página de GitHub) o utiliza un token de acceso personal. El token se guarda únicamente en el llavero de su sistema.

Conectar GitLab

GitTree se conecta a gitlab.com o a un host GitLab autoadministrado que usted nombre. Inicie sesión con el navegador a través de una aplicación OAuth (para gitlab.com se utiliza la propia GitTree) o utilice un token de acceso personal de ese host. El token se utiliza únicamente para ese host.

Conecte la nube de Bitbucket

GitTree se conecta a Bitbucket Cloud (bitbucket.org) de tres maneras: inicia sesión con tu cuenta de Bitbucket en el navegador, usa un token API de Atlassian con el correo electrónico de la cuenta o usa un token de acceso al espacio de trabajo, proyecto o repositorio. Los tokens se guardan únicamente en el llavero de su sistema.

Conecte el centro de datos de Bitbucket

Para un servidor de Bitbucket Data Center de una empresa, asigne un nombre a su host, luego use un token de acceso HTTP personal o inicie sesión con el navegador a través del enlace de aplicación OAuth entrante que su administrador creó para GitTree. GitTree habla solo con ese host.

Conecte Azure DevOps

Inicie sesión con su cuenta de Microsoft en el navegador o use un token de acceso personal de Azure DevOps. GitTree habla con dev.azure.com y con el servicio de perfiles de Microsoft para encontrar sus organizaciones y luego enumera sus repositorios, solicitudes de extracción y canalizaciones.

Conecte servidores empresariales y autohospedados

GitTree se conecta a los servidores propios de tu empresa: GitHub Enterprise Server, autogestionado GitLab y Bitbucket Data Center. Tú nombras al anfitrión; GitTree habla con https:// solo ese host y el token se usa solo para ese host. El inicio de sesión en el navegador necesita una aplicación OAuth que su administrador haya registrado allí.

Consultar disponibilidad de integración

No todos los proveedores ofrecen lo mismo. La pestaña Integrations de la Guía de funciones muestra, para el proveedor del repositorio abierto y su cuenta, qué es Available, qué es Not offered by ese proveedor y qué es Coming soon.

Explorar y crear repositorios de proveedores

Con una cuenta conectada, Clone a repository enumera los repositorios de esa cuenta por Owner, con búsqueda, por lo que no es necesario copiar una URL. Publish Repository… va al revés: crea el repositorio en su cuenta, lo agrega como remoto y empuja su rama.

Utilice tenedores de GitTree

Una bifurcación es su propia copia de un repositorio en el proveedor. Create Fork… le pide al proveedor que cree uno; Add Remote from Fork… agrega una bifurcación existente como remota. Crear una bifurcación no cambia nada en su repositorio hasta que la agrega, y un control remoto existente nunca se reemplaza.

Solicitudes de extracción

Con una cuenta de hosting conectada, GitTree enumera las solicitudes de extracción del repositorio en el panel izquierdo y abre cada una junto al gráfico: su conversación, confirmaciones, archivos y comprobaciones, con Review… y Merge…. Las solicitudes de extracción son parte de GitTree Pro.

Crear una solicitud de extracción o fusión

Haga clic derecho en su sucursal y elija Start a Pull Request…. Elija lo que fusiona From y Into, escriba Title y Description, agregue revisores, opcionalmente Open as a draft, y presione Create Pull Request. Primero se presiona una rama que aún no está en el control remoto.

Revisar y discutir cambios.

Abra la solicitud de extracción, lea Files y presione + junto a una línea para agregar un comentario de línea a su revisión. Review… envía su decisión (Approve, Request changes o Comment) con un Summary y cada línea de comentario. Las conversaciones se pueden responder y resolver donde el proveedor lo admita.

Fusionar o cerrar una solicitud de extracción

Merge… pregunta al proveedor cómo se puede fusionar la solicitud de extracción, muestra si es Ready to merge y ofrece solo las Merge method que permite el repositorio. GitTree se fusiona solo mientras el encabezado sigue siendo el compromiso que miraste; si llegan nuevas confirmaciones, no se fusiona nada.

Utilice acciones de problemas admitidas

La sección Issues del panel izquierdo enumera los problemas abiertos del repositorio. Abra uno para leer y comentar, cree uno con New Issue… o comience a trabajar con Create Branch from Issue…. Los problemas de cierre y edición ocurren en la página del proveedor: Open Issue in Browser.

Inspeccionar cheques y confirmar el estado

GitTree muestra el estado de CI de las confirmaciones y solicitudes de extracción: Checks passing, Checks failing, Checks running, Checks skipped o No checks reported, con cuántas se aprobaron, fallaron, se ejecutaron o se omitieron. Selecciónelo para ver las ejecuciones, abrir el registro de una verificación o Re-run Check.

Ejecuciones de CI/CD

GitTree muestra las ejecuciones de CI/CD del host de su repositorio, como las acciones GitHub, en el panel izquierdo y en una lista completa al lado del gráfico: qué pasó, qué falló y por qué, con Re-run Failed Jobs, Cancel Run… y Run Workflow…. CI/CD es parte de GitTree Pro.

Explorar y filtrar ejecuciones

La lista CI/CD muestra cada ejecución del repositorio y se actualiza por sí sola mientras se realizan las ejecuciones. Filters reducirlo en Branch, Workflow, Status y Trigger; Mine mantiene tus carreras; Watch mantiene una ejecución actualizándose en segundo plano y le avisa cuando finaliza.

Leer trabajos y registros

Abra una ejecución y seleccione un trabajo o paso para leer su registro en la pestaña Log. Jump to first error va directamente al error, Search the log… encuentra texto, Timestamps y Wrap cambian la vista, Following mantiene a la vista la salida en vivo de un trabajo en ejecución y Save Log… lo escribe en un archivo.

Volver a ejecutar o cancelar una canalización

Desde una ejecución, Re-run Failed Jobs repite solo lo que falló, Re-run All Jobs repite todo y el menú de un trabajo vuelve a ejecutar solo ese trabajo (Retry Stage en etapas de estilo GitLab). Cancel Run… lo detiene; Force Cancel Run… lo finaliza sin dejar que los trabajos se limpien. Ninguna cancelación se puede deshacer.

Ejecutar un flujo de trabajo

Run Workflow… inicia un flujo de trabajo que se puede ejecutar manualmente, como un flujo de trabajo de acciones GitHub con un activador workflow_dispatch o una canalización de Bitbucket custom. GitTree lee sus entradas del archivo de flujo de trabajo en la rama que elija y muestra un campo para cada una.

Descargar artefactos disponibles

La pestaña Artifacts de una ejecución enumera los archivos que produjo, con Name, Size y cuando Expires. Save… pregunta dónde guardarlo y lo descarga allí, ya que el proveedor lo almacena; un zip se guarda como zip y GitTree no lo abre.

Inspeccionar implementaciones y entornos

Una ejecución que se implementa muestra Deploys to … y una pestaña Environments: cada entorno, su implementación, rama o confirmación y cuándo. Una implementación que espera muestra Waiting for approval; si eres uno de sus revisores, Approve Deployment… y Reject Deployment… actúa en consecuencia. Estos cambian las cosas para todos y no se pueden deshacer.

Crear y verificar archivos de canalización

New CI/CD File… escribe un archivo inicial donde su proveedor lo lee, como .github/workflows/ o .gitlab-ci.yml; nunca escribe sobre un archivo existente. Edítelo en GitTree, presione Check with … para que el proveedor lo valide y luego confírmelo como cualquier archivo.

Administrar la configuración de la canalización

CI/CD Settings muestra lo que el proveedor permite administrar a otra aplicación: Variables, Secrets, Environments, Runners, Schedules, Caches, Definitions y Releases. El valor de un secreto se escribe en un mensaje seguro del sistema o se lee desde un archivo que usted elija y va directamente al proveedor; GitTree nunca lo muestra, lo guarda ni lo envía a ningún otro lugar.

Utilice controles de liberación de tuberías

CI/CD Settings › Releases enumera las versiones del repositorio. New Release nombra una etiqueta (o crea una a partir de una rama o confirmación), con un Title, Notes (Markdown) y archivos que la gente puede descargar. Se publica una versión para todos los que pueden ver el repositorio a menos que usted Save as a draft.

Preguntar a Nour sobre un error en la canalización

Explain Failure abre Nour con una pregunta sobre una ejecución fallida. Nour lee el registro del paso fallido (como máximo 64 KiB) solo si lo apruebas, siempre, y responde con lo que cree que salió mal y qué intentar. Trate la respuesta como un consejo: compruébela con el registro.

Configura Nour, el asistente de IA

Nour es el asistente de inteligencia artificial de GitTree. Ejecuta la CLI del agente de codificación que ya utiliza, como Claude Code, Codex o Gemini CLI, con su propia suscripción: GitTree nunca ve sus claves. En el modo Ask Nour solo mira y responde; en modo Agent puede actuar dentro de lo que tú permitas. Nour es parte de GitTree Pro.

Pregunta a Nour sobre tu trabajo

Nour siempre conoce el repositorio y la rama retirada del chat. Escriba @ para mencionar un archivo, carpeta, rama, confirmación o solicitud de extracción, adjuntar un archivo o informar a Nour sobre otras ramas. Los chips encima del cuadro de mensaje muestran What Nour is told; el selector de alcance decide qué repositorios cubre el chat.

Revisar Nour acciones de la aplicación

En el modo Agent, Nour puede actuar en GitTree a través de sus propios comandos: abrir vistas, preparar, confirmar, buscar, enviar y más. Cada acción pertenece a un tipo (Look around, Change you can undo, Risky) y sigue tu elección; cualquier cosa arriesgada siempre espera que usted haga clic en una tarjeta de aprobación.

Redactar una solicitud de confirmación o extracción

El cuadro de confirmación y el cuadro de diálogo de solicitud de extracción pueden redactar su texto con una CLI de agente de codificación que haya instalado: Generate commit message with … lee los cambios preparados y Draft the title and description with … lee las confirmaciones de su rama. Usted revisa y edita el borrador; no se confirma ni se abre nada hasta que presiona el botón.

Administrar Nour sesiones

Cada chat se guarda por repositorio en Chat history. Stop finaliza la respuesta actual; Nour también detiene a un agente que no imprime nada durante demasiado tiempo. Si el agente elegido no puede responder (no ha iniciado sesión, no queda uso, falta el modelo), otro agente instalado puede responder en su lugar y Nour dice el motivo.

Revisar Nour privacidad y recuperación

Antes de cada turno que pueda cambiar archivos, Nour guarda una instantánea del árbol de trabajo; Changes from this turn enumera lo que cambió y Undo this turn devuelve el árbol de trabajo. Una instantánea no cubre envíos ni archivos fuera del repositorio. Sus mensajes van al agente CLI que eligió, según la política de su propio proveedor; GitTree nunca almacena una clave API ni llama a un modelo por sí mismo.

Configurar agentes y modelos

Preferencias › Nour (AI) › Agents enumera las CLI del agente GitTree encontradas, marcadas Installed o Not installed. Elija Agent for new chats, un Model para cada uno (vacío usa el valor predeterminado del agente) y el Automatic selection order que sigue a First one installed. Test verifica que un agente funcione en esta computadora.

Buscar y cambiar preferencias

Preferencias tiene una página por área, como General, Profiles, SSH, Integrations, Nour (AI), External Tools y UI Customization, más Repo-Specific Preferences para cada repositorio abierto. Search preferences busca una configuración por nombre, descripción o clave, y cada configuración dice dónde Saves to: App, Profile o Repository.

Apariencia y lenguaje

Preferencias › UI Customization establece Theme (versiones claras, oscuras y de alto contraste), Follow the system appearance, Language (inglés o árabe, de derecha a izquierda), Zoom, cómo se muestran Dates y Reduce motion.

Configurar Git y el comportamiento del repositorio

Preferencias › General contiene cómo GitTree controla Git: Git executable, Pull mode, Auto-fetch interval, opciones de rebase, Long paths y Line endings. Repo-Specific Preferences anula algunos de ellos para un repositorio, como su Base branch, la búsqueda automática, la plantilla de confirmación y cómo detecta los cambios en los archivos.

Administrar identidades y perfiles de Git

Un perfil es un nombre y un correo electrónico para confirmaciones, además de una clave de firma opcional y un comando SSH, entre los que puede alternar. De forma predeterminada, se ejecuta Passed to each git command GitTree, por lo que ~/.gitconfig nunca se cambia y el propio nombre o correo electrónico del repositorio sigue prevaleciendo; Written to ~/.gitconfig hace que todas las herramientas de git lo utilicen.

Configurar SSH en GitTree

Preferencias › SSH enumera las claves en su carpeta .ssh, crea claves nuevas, muestra cada host desde su configuración SSH y prueba una conexión. GitTree nunca inicia un agente SSH y nunca edita ~/.ssh/config o core.sshCommand; una clave que elija para los controles remotos SSH se pasa a los comandos git que ejecuta.

Configurar confirmación y firma de etiquetas

Preferencias › Commit Signing elige Format (OpenPGP, clave SSH o X.509) y Key, y si Sign every commit y Sign every annotated tag. No se escribe nada hasta que presionas Apply to Global Git Config. El gráfico y los detalles de la confirmación muestran el estado de firma de cada confirmación.

Configurar herramientas y codificación de archivos.

Las diferencias y los archivos que no son UTF-8 se leen con Preferencias › Editor › Default encoding; una marca de orden de bytes siempre gana y los bytes que no encajan se muestran como �. Line endings (core.autocrlf) decide cómo git convierte CRLF y LF, y Long paths permite que git cree rutas de más de 260 caracteres en Windows.

Configurar notificaciones y registros

Preferencias › Notifications establece Where notifications appear, si es Show success notifications y Desktop notifications de su sistema. Extended logging en General escribe más detalles en el registro local, desde el próximo lanzamiento, para ayudar a diagnosticar un problema; no se envía nada a ninguna parte.

Configurar privilegios Nour

Dos configuraciones enlazadas Nour. What Nour may do in a repository establece lo que el propio agente puede hacer allí: Read only, Edit files, no commands o Everything, as in a terminal. What Nour may do in GitTree establece, para cada tipo y área de acción de la aplicación, Never, Ask me first o On its own; Los cambios arriesgados siempre preguntan.

Configurar la actualización de la integración

Preferencias › Integrations controla cómo GitTree lee sus cuentas de alojamiento: qué antigüedad pueden tener las listas antes de Refresh pull requests, issues and checks, si deben Refresh when I come back, los valores predeterminados del registro CI/CD y de dónde provienen las imágenes del autor. La lectura ocurre solo mientras la ventana de GitTree está al frente.

Hacer una copia de seguridad, importar o restablecer la configuración

Preferencias › General › Back up, restore and reset exporta la configuración de su aplicación, sus perfiles y su configuración de Git a un archivo, importa dicho archivo o restablece todo. Una exportación nunca contiene contraseñas, tokens o detalles de cuenta, ni la configuración de ningún repositorio. La configuración de Git de una importación se escribe en ~/.gitconfig solo después de que la revises.

Buscar e instalar actualizaciones

GitTree no puede encontrar Git

GitTree usa tu propia instalación de Git y nunca incluye ni instala una. Si no se encuentra ninguno, muestra GitTree needs Git; si el encontrado es anterior a 2.39 muestra This Git is too old. Instala o actualiza Git, o presiona Locate Git… para elegirlo, luego Check again.

No se abre un repositorio

Cuando no se puede abrir una carpeta, GitTree dice por qué y ofrece el siguiente paso: This folder is not a Git repository (inicializar o elegir otra), This cannot be opened as a repository (ruta faltante), GitTree cannot read this folder (permisos) o This repository belongs to another user (verificación de propiedad de Git).

Los cambios no son refrescantes.

GitTree nota las ediciones realizadas en otros programas a través de las notificaciones de cambios de su sistema. En las carpetas WSL y los recursos compartidos de red, esas notificaciones no llegan, por lo que Automatic revisa la carpeta cada pocos segundos. Si los cambios aún aparecen tarde, fuerce el modo de verificación para ese repositorio o actualice manualmente.

Falló un intento de autenticación remota

Primero, Git inicia sesión en un control remoto con su propio asistente de credenciales o clave SSH. … needs you to sign in. significa que no hay respuesta; … refused the credentials sent for this repository. significa que lo que se envió ya no es válido o no está permitido. Arreglar las credenciales que usa Git; una cuenta conectada se completa solo cuando tus ayudantes no tienen nada, o cuando la eliges como repositorio.

Un empujón fue rechazado

Se rechaza un envío por una de tres razones, y GitTree dice cuál. The remote refused …: el control remoto tiene confirmaciones, tu rama no. The remote declined the push: una protección de gancho o rama dijo que no, con su motivo. … moved: un envío forzado con arrendamiento encontró que el control remoto ya no estaba donde lo recogió por última vez, por lo que no se reemplazó nada.

Una operación de Git necesita atención

Cuando una fusión, cambio de base, selección, reversión o bisección se detiene parcialmente, GitTree muestra un banner como Rebasing … onto …, step 3 of 7 y marca la pestaña rebase in progress. La mayoría de los comandos esperan hasta que finalice: resuelva cualquier conflicto, luego Continue, Skip el paso o Abort… para volver al punto de partida.

Una acción de integración no está disponible

Cuando no se puede utilizar una acción de alojamiento, GitTree dice el motivo en lugar de fallar silenciosamente. Las razones habituales son: es parte de GitTree Pro; no hay ninguna cuenta conectada para el host del control remoto; es necesario volver a conectar el token; su rol en el proveedor no lo permite; el proveedor no lo ofrece; o el proveedor está limitando las solicitudes por un tiempo.

Nour no puede comenzar ni terminar

Nour ejecuta una CLI de agente de codificación en su computadora, por lo que la mayoría de los problemas son de la CLI: no está instalado, no ha iniciado sesión, no queda uso, el modelo que configuró no está disponible o necesita Node.js. GitTree también se niega a iniciar un turno en un repositorio restringido, o cuando no puede guardar la instantánea que hace que el turno se pueda deshacer.

No se puede cargar una tubería o un registro

GitTree dice por qué falta una ejecución o un registro: This repository’s host does not list … runs., This log has expired on …, This account may not read logs here., … offers no log from outside its own page., o que el proveedor está limitando las solicitudes. La mayoría tiene una solución; algunos solo abren la página del proveedor.

Error en un conjunto de claves o solicitud SSH

GitTree mantiene los tokens de cuenta, su inicio de sesión y las frases de contraseña SSH recordadas solo en el llavero de su sistema: macOS Keychain, Windows Credential Manager o Secret Service (GNOME Keyring o KeePassXC) en Linux. Cuando el llavero dice que no, GitTree te pide que permitas el acceso y vuelve a intentarlo; nunca vuelve a recurrir a un archivo.

Utilice GitTree sin conexión

GitTree es local primero: todas las funciones locales de Git funcionan sin conexión, incluidas confirmaciones, bifurcaciones, fusiones, rebases, escondites, historial y deshacer. Obtener, extraer, enviar, integraciones de alojamiento, CI/CD y el proveedor de Nour necesitan la red; mientras está fuera de línea GitTree muestra los últimos datos que leyó y lo dice.

Recopile y comparta un informe de soporte

Cuando GitTree detecta un error, guarda un informe en esta computadora; no se envía nada a ninguna parte. Report a Bug… muestra lo que se copiaría (el informe guardado con tokens y contraseñas eliminados, o un breve resumen), le permite elegir y luego abre el formulario de soporte en el sitio web de GitTree para que lo pegue. Contact Support… escribe a la dirección de soporte.