Inicio rápido

Esto da por hecho que Wyrm está instalado y que has iniciado sesión. Los atajos son los de macOS.

1. Abre un repositorio

Después de iniciar sesión, Wyrm muestra Abre un repositorio para empezar con tres botones:

Abrir… (⌘O): una carpeta que ya tienes, Git o jj.
Clonar… (⌘⇧O): copia en tu Mac un repositorio de GitHub, GitLab o cualquier URL de Git.
Nuevo repositorio… (⌘⇧N): empieza un repositorio nuevo en una carpeta vacía o existente.

Tu repositorio Git existente

Abre una carpeta Git normal y Wyrm te pregunta primero, con Repositorio Git detectado: «Este es un repositorio Git. Wyrmflow inicializará jujutsu junto a Git para que puedas usar ambas herramientas.» Haz clic en Abrir repositorio.

Qué hace eso:

Crea una carpeta .jj/ junto a .git/. Tu .git/, tus ramas y tu historial se quedan como están.
.jj/ se oculta de git status con su propio archivo de ignorados. El .gitignore de tu proyecto no cambia, así que no hay nada nuevo que hacer commit.
Para tus compañeros no cambia nada. Siguen usando Git; lo que tú subes con push son commits y ramas de Git normales.
Puedes seguir ejecutando git en la misma carpeta. Es normal que git status indique un HEAD separado (detached): así es como jj y Git comparten una carpeta.

2. Lee el log

El log es tu historial en forma de grafo, con lo más reciente arriba. Cada fila es un commit: su change ID, su descripción, su autor y su antigüedad. La fila con el halo verde es @, tu copia de trabajo. En jj, los archivos que estás editando siempre son un commit, así que no hay una zona aparte de «cambios sin confirmar».

Haz clic en una fila para ver sus cambios en el panel de revisión. Usa ↑ / ↓ para moverte por el log y G para volver a @. Más en Grafo del log.

3. Haz un cambio

Edita un archivo en tu editor y guárdalo. Wyrm recoge el cambio en @; la fila se actualiza y el archivo aparece entre sus cambios. No hay nada que preparar en un staging.

4. Descríbelo

Selecciona @ y escribe un mensaje en Describe este cambio… del panel de revisión; después pulsa ↩ para guardarlo. D abre lo mismo como diálogo, Editar descripción.

Cuando el cambio esté terminado, pulsa ⌘↩ (o haz clic en Terminar cambio). Eso ejecuta jj commit: mantiene tu mensaje en este commit y empieza encima un @ nuevo y vacío para el siguiente trabajo. Para empezar un commit nuevo encima de cualquier otro commit, selecciónalo y pulsa N (o ⌘N, Nuevo hijo).

5. Haz push, con vista previa

A los remotos de Git se les hace push de bookmarks (el nombre que jj da a las ramas).

Selecciona el commit que acabas de terminar y pulsa B (Crear marcador…). Dale un nombre como fix-typo.
Haz clic en Push en la barra superior. Todavía no se envía nada: Wyrm abre Push a origin y lista cada bookmark con lo que le va a pasar: Nuevo, Actualización, Eliminar, o Divergente si tu bookmark y el del remoto han tomado caminos distintos.
Revísalo y haz clic en Push de 1 marcador.

La vista previa compara con el último fetch, así que haz clic antes en Fetch si puede que tus compañeros hayan hecho push. Detalles en Vista previa de push. Para abrir un pull request desde el bookmark, consulta Pull y merge requests.

6. Deshaz

Haz clic en Undo en la barra superior o pulsa ⌘Z. En jj, deshacer funciona sobre operaciones: un describe, un rebase, un abandon. Deshacer no recupera los commits que ya están en el remoto. Cada undo retrocede una más, y ⌘⇧Z rehace. El panel Operaciones de la barra de iconos lista todas las operaciones, y puedes restaurar el repositorio a cualquiera de ellas. Consulta Deshacer y el log de operaciones.

Siguientes pasos

De Git a jj, paso a paso: cada costumbre de Git junto a su equivalente en jj.
Editar el historial: divide, haz squash, absorbe y mueve cambios.
Atajos de teclado: pulsa ? en la app para ver la misma lista.