Escribir, Confirmar, Marcar y Empujar: Guía de control de versiones para principiantes con jj

Guía práctica de jj: control de versiones sobre Git. Configuración, commits, bookmarks y push a GitHub con ejemplos para principiantes.

viernes, 29 de agosto de 2025 • 4 min de lectura • Equip Q2BSTUDIO

Inteligencia-Artificial-

Escribir Commit Bookmark Push - Guía de control de versiones para principiantes con jj

jj es un sistema de control de versiones moderno que funciona sobre git y ofrece una experiencia más simple e intuitiva para desarrollar y gestionar historial de cambios. En esta guía práctica traducida al español explico los pasos esenciales para empezar, desde configurar jj hasta crear, versionar y publicar una pequeña funcionalidad en GitHub. Al final encontrarás información sobre Q2BSTUDIO y cómo podemos ayudar con aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad y servicios cloud.

Configuración inicial y personalización

Para empezar conviene personalizar jj y evitar que el log por defecto sea abrumador. Crea el archivo de configuración en la ruta ~/.config/jj/config.toml y define secciones básicas como user con tu name y email, ui con default-command apuntando a una vista de log compacta y editor apuntando a tu editor favorito, y plantillas que simplifiquen la salida del log. Estas opciones hacen que jj muestre solo lo esencial y que tu flujo sea más claro desde el primer momento.

Crear el proyecto y preparar el repositorio

1 Crear la carpeta del proyecto ejecutando mkdir jj-hello-world y entrar con cd jj-hello-world. 2 Inicializar el soporte git para que jj pueda integrarse con GitHub ejecutando jj git init.

Primer cambio y flujo básico

Ejecuta jj log para ver el estado inicial. Un repositorio nuevo muestra siempre dos commits especiales: el root commit marcado por la base del historial y el working copy commit marcado con el simbolo que indica el espacio de trabajo activo. Cuando crees archivos o realices cambios el working copy deja de estar vacio.

Escribe un cambio sencillo creando un archivo main.py y añadiendo una instruccion que imprima hello world. jj detecta automaticamente el cambio en el working copy, por eso al volver a ejecutar jj log el tag empty desaparece y puedes inspeccionar el cambio con jj diff.

Realiza el commit del cambio usando jj commit -m Add hello world. Tras el commit veras el nuevo commit en el log y un nuevo working copy vacio listo para seguir trabajando.

Publicar en GitHub mediante bookmark y push

En GitHub crea un repositorio vacio y añade el remoto con git remote add origin seguido de la URL de tu repositorio. Para que jj sepa qué commit debe corresponder a la rama main remota crea un bookmark local que apunte a tu commit, por ejemplo jj bookmark create main -r x donde x es el identificador corto del commit. Por ultimo sube los cambios con jj git push --allow-new. Con esto tu commit ya aparece en GitHub como la rama main.

Flujos colaborativos y pull requests

Con jj es sencillo crear pequeñas ramas, corregir commits y mantener pilas de cambios limpias antes de abrir pull requests. Al trabajar con GitHub normalmente creas una rama o bookmark, empujas el trabajo y abres el pull request desde la interfaz de GitHub. Si necesitas ajustar algo puedes enmendar commits localmente con jj y volver a empujar para actualizar el PR.

Ventajas de usar jj en equipos y proyectos profesionales

jj aporta una interfaz menos verbosa, manejo intuitivo del working copy y herramientas para trabajar con sets de cambios relacionados. Esto acelera revisiones de codigo, facilita reordenar commits y reduce errores comunes al preparar pull requests, todo lo cual mejora la productividad del equipo y la calidad del software.

Sobre Q2BSTUDIO

Q2BSTUDIO es una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida para empresas que buscan soluciones adaptadas a su negocio. Ofrecemos servicios en inteligencia artificial e ia para empresas, desarrollo de agentes IA, ciberseguridad, servicios cloud aws y azure, y soluciones de inteligencia de negocio incluyendo power bi para visualizacion y analitica. Nuestro equipo diseña arquitecturas seguras y escalables, integra modelos de inteligencia artificial para automatizar procesos y potencia decisiones con dashboards de inteligencia de negocio. Si necesitas desarrollos a medida, consultoria en ciberseguridad, migracion a servicios cloud aws o azure, o implementacion de modelos de ia para empresas, Q2BSTUDIO puede acompañarte en todo el ciclo del proyecto.

Palabras clave y posicionamiento

Para mejorar el posicionamiento en busqueda y comunicar claramente nuestros servicios incluimos terminos relevantes como aplicaciones a medida, software a medida, inteligencia artificial, ia para empresas, agentes IA, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio y power bi. Estos conceptos representan el núcleo de nuestras ofertas y ayudan a encontrar soluciones de alto valor para clientes que demandan transformacion digital y seguridad.

Contacto y siguiente paso

Si quieres que te ayudemos a integrar flujos modernos de control de versiones con herramientas como jj, o necesitas desarrollar una aplicacion a medida que aproveche inteligencia artificial y servicios cloud, ponte en contacto con Q2BSTUDIO. Podemos auditar tus procesos, proponer una arquitectura segura y construir soluciones escalables que impulsen tu negocio.

Resumen rapido de comandos esenciales

mkdir jj-hello-world cd jj-hello-world jj git init editar main.py jj diff jj commit -m Add hello world git remote add origin tu_url_remota jj bookmark create main -r x jj git push --allow-new

Con estos pasos basicos tendrás una linea de trabajo clara para escribir, commitear, marcar y publicar cambios utilizando jj, y una puerta abierta para integrar todo esto con los servicios profesionales de Q2BSTUDIO en aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure y soluciones de inteligencia de negocio con power bi.

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.