La guía de Jujutsu para programar con agentesDales rienda suelta a tus agentes de IA. Deshaz cualquier cambio, reescribe todo.

Jujutsu ( jj ) es un sistema de control de versiones compatible con Git, con snapshots automáticos, undo universal y una reescritura del historial tan segura como intuitiva. Esta guía práctica enseña a quienes ya usan Git a experimentar sin miedo, a recuperarse de cualquier cosa y a convertir los cambios que genera la IA en un historial limpio y fácil de revisar.

Vista previa de 46 páginas

Comprar en Leanpub Comprar en Amazon

Por qué existe este libro

Dos décadas con Git. Después, los agentes de IA me llevaron a Jujutsu.

Durante años, nunca cuestioné Git. Era, sencillamente, lo que se usaba. No había una alternativa real y tampoco me puse a buscarla. Entonces los agentes de IA llegaron a mi trabajo diario y el ritmo cambió.

Los agentes generan, reescriben y descartan grandes cantidades de código en cuestión de minutos. Git no alcanza a seguirles el ritmo. Llegué a perder cambios por accidente y no pude recuperarlos. Terminé con historiales tan enredados que era imposible reorganizarlos en algo que alguien quisiera revisar. Más de una vez, yo misma rompí el historial al usar un comando de Git que solo entendía a medias.

Entonces descubrí Jujutsu, basado en un modelo distinto. No hay área de staging: cada modificación pasa a formar parte del historial en cuanto la haces. Cualquier operación se puede deshacer. Retroceder por el historial para editar un change anterior es tan normal como editar el archivo que tienes enfrente. Por primera vez en años, pude trabajar tranquila con el control de versiones.

Pero Jujutsu tiene un problema: su curva de aprendizaje. Veía una y otra vez cómo la gente lo probaba y volvía a Git a los pocos días. Su modelo mental no es el de Git, así que una tabla de equivalencias de comandos no basta. Si te limitas a sustituir cada comando de Git por su equivalente en Jujutsu, nunca entenderás qué hace que Jujutsu sea mejor. Para aprender Jujutsu de verdad, hace falta una guía que empiece por sus conceptos y los aplique en un flujo de desarrollo real con agentes de IA. Nadie había escrito una, así que la escribí yo.

Salida de jj log con un grafo de changes, sus change IDs, autores, marcas de tiempo y descripciones

Lo que vas a aprender

Piensa en changes y sus revisions, no en commits. El modelo es distinto del de Git y, una vez que lo interiorizas, te resultará mucho más lógico.
Gestiona el historial con el evolution log, que muestra los estados anteriores de un change, y el operation log, que registra cada comando que ejecutas. Despídete de tener que hacer arqueología con reflog.
Convierte montañas de código generado por IA en un historial limpio y fácil de revisar.
Trabaja en paralelo en varias tareas y con varios agentes de IA mediante workspaces.
Integra el historial sin miedo: resuelve conflictos de forma segura e inteligente con jj.
Publica tu trabajo en GitHub y colabora como siempre con equipos que usan Git.

Sobre el estilo de este libro

El diálogo no es decoración. Es la forma en que el libro enseña.

Juju-chu! está escrito de principio a fin como un diálogo entre dos ingenieras de software: una veterana que conoce Jujutsu a fondo y una novata que no deja de preguntar por qué.

Cuando te surge una duda, lo más probable es que la novata también la plantee. “Si no controlas cuándo se crean los commits, ¿no termina el historial hecho un caos?” “Si edito un change anterior, ¿no tengo que hacer rebase de todo lo que viene después?” Las ideas equivocadas se corrigen a medida que surgen, y los casos límite se abordan en la conversación en lugar de quedar enterrados en notas al pie.

Enseñar mediante el diálogo es casi tan antiguo como enseñar. Así escribió Platón La República, así recogieron los discípulos de Confucio las Analectas, y así lo sigue haciendo hoy The Little Schemer. En Japón, este es el formato con el que mi serie Riakuto! vendió más de 40 000 ejemplares. Lee la muestra y comprueba si te resulta fácil de leer.

Diálogo entre la senpai y el kōhai, tal como aparece en el libro

Contenido por capítulos

Capítulo 1

¿Qué clase de herramienta es Jujutsu?

Git se diseñó pensando en equipos humanos que escriben el código con cuidado y después hacen staging, organizan los cambios y los integran. Este capítulo analiza qué partes de ese modelo empiezan a generar fricción cuando un agente escribe el código y tú iteras a velocidad de máquina.

Luego llega la respuesta de Jujutsu: snapshots automáticos, undo universal, conflictos de primera clase y un conjunto de comandos intuitivo y fácil de recordar. Jujutsu está pensado para empezar de forma desordenada y ordenarlo todo después, justo lo que necesita la era de la IA.

Capítulo 2

Vamos a probar Jujutsu

Tras la instalación y la configuración inicial, recorrerás un flujo de desarrollo completo con Jujutsu en un proyecto pequeño: crear changes, leer y reescribir el historial y publicar tu trabajo haciendo push. También conocerás los tres logs de Jujutsu: el revision log; el evolution log, que muestra cómo evoluciona un change; y el operation log, que registra las operaciones sobre el repositorio.

Después llega el modelo mental que hace encajar todo lo demás: qué son en realidad los changes y los bookmarks, y por qué en Jujutsu lo normal es trabajar en branches anónimas.

Capítulo 3

El flujo Jujutsu × IA en la práctica

Este capítulo muestra cómo configurar Claude Code y Codex CLI para que usen Jujutsu en lugar de Git y, lo que es más importante, para que trabajen según el modelo mental de Jujutsu en vez de limitarse a traducir comandos de Git.

Después pondrás esa configuración en práctica con Claude Code. El agente trabajará en changes bien delimitados, hará push de su trabajo y abrirá un PR. También le darás a propósito tareas mezcladas y aprenderás a reorganizar el resultado por tu cuenta en un historial limpio. Por último, ejecutarás varias sesiones de agente en workspaces paralelos e integrarás sus resultados.

Capítulo 4

Técnicas avanzadas de Jujutsu

Empezarás por los revsets y los filesets, lenguajes de consulta que permiten seleccionar con precisión las revisions y los archivos que necesitas. Después conocerás tres comandos para usuarios avanzados: jj absorb, que incorpora cada corrección al change al que pertenece, y los comandos más recientes jj arrange y jj bookmark advance.

A partir de ahí, configurarás tus propias tareas pre-push para que se ejecuten al hacer push, reducirás la resolución manual de conflictos con Mergiraf y Weave, y verás dos herramientas con interfaz de usuario: jjui y JJ View.

Capítulo 5

Guía de resolución de problemas de Jujutsu

Las preguntas frecuentes responden a las dudas que los usuarios de Git repiten una y otra vez: por qué no hay comandos merge ni pull, cómo hacer el equivalente de cherry-pick, cómo mantener los archivos temporales fuera del historial y si Jujutsu no es, en el fondo, más que un simple envoltorio sobre Git.

Después vienen los problemas que te dejan bloqueado. Un push normal que, sin avisar, se convierte en force push. El error working copy is stale. Un change marcado como divergent. Y tu working-copy commit, que se mueve inesperadamente después de mergear un PR y hacer fetch de los cambios.

Archivos de configuración gratuitos: haz que tu agente de IA use Jujutsu en vez de Git

Para quién es este libro (y para quién no)

Le sacarás el máximo provecho a Juju-chu! si:

Tu agente de IA escribe la mayor parte de tu código y tener que detenerte para hacer staging y gestionar en Git cada tanda de cambios te parece una fricción innecesaria.
Has perdido trabajo y no has podido recuperarlo, ya sea por un git reset --hard accidental, por un stash al que le perdiste el rastro o por un comando de Git que tu agente ejecutó por su cuenta.
Ordenar los enormes diffs que genera la IA se ha vuelto una tarea tediosa, y cuando algo sale mal Git tiene demasiados comandos y casos límite como para tenerlos todos presentes.
Todavía contienes la respiración durante un rebase de Git, por temor a que un conflicto se convierta en un lío o a que un paso en falso rompa el historial.
Te interesa Jujutsu, pero quieres entender cómo funciona realmente y cómo incorporarlo a tu trabajo diario de desarrollo con agentes de IA, no limitarte a memorizar una lista de comandos.

Este libro probablemente no sea para ti si:

Apenas estás empezando con Git y GitHub. El libro da por sentado que ya sabes usar Git y parte de ahí.
Manejas reflog y el rebase interactivo con absoluta soltura y sientes que tu flujo de trabajo con Git no te genera la menor fricción.
No usas agentes de IA para programar. El libro se centra en el desarrollo junto con agentes de IA, que es donde más brilla Jujutsu, por lo que algunas partes quizá no te resulten relevantes.

Sobre la autora

Escrito por Yuka Ooka

Yuka Ooka es una ingeniera japonesa especializada en desarrollo web y autora de libros técnicos. Su serie de libros sobre React + TypeScript, Riakuto! (りあクト！), ha vendido más de 40 000 ejemplares.

Trabajó en Rakuten y otras empresas japonesas. A lo largo de su carrera, pasó de PHP a Ruby on Rails y después a React, con una etapa intermedia como product manager de un portal de empleo. En 2016 comenzó a trabajar de forma independiente. Fue una de las primeras personas en adoptar React en Japón y asumió proyectos para clientes como especialista en React. Riakuto! nació de su experiencia capacitando a los ingenieros junior que se incorporaban a esos equipos.

Su libro más reciente, Juju-chu!, es el primero del mundo dedicado al sistema de control de versiones Jujutsu y a su uso junto con agentes de IA para programar, como Claude Code.

La historia completa

Consigue el libro

Recomendado
PDF + EPUB
Desde12 US$USD
- PDF y EPUB sin DRM, los dos incluidos
- Listados de comandos que puedes copiar y buscar
- Actualizaciones gratuitas de esta edición
- La mejor forma de apoyar a la autora
Comprar en Leanpub
Kindle
12 US$USD
- Se lee en cualquier dispositivo o aplicación de Kindle
- Texto adaptable, con sincronización y notas
- Disponible al instante en tu biblioteca Kindle
Comprar en Amazon
Tapa blanda
18,50 US$USD
- La única forma de tener un ejemplar físico
- 168 páginas, 15 × 23 cm: cabe junto al teclado
- Impreso y enviado por Amazon en tu región
Comprar en Amazon

Preguntas frecuentes

¿Necesito experiencia previa con Jujutsu?

No. El libro comienza con la instalación y avanza a partir de ahí; no presupone ningún conocimiento previo de Jujutsu. Kanae, la ingeniera junior que aparece en el diálogo, tampoco ha usado nunca Jujutsu, así que aprendes junto con ella.

También está pensado para quienes ya probaron Jujutsu y lo abandonaron porque su modelo mental es muy distinto del de Git. El libro dedica tiempo a aclarar esa diferencia: qué es realmente un change, por qué el commit ID cambia mientras el change ID permanece igual y dónde puede engañarte tu intuición de Git.

¿Necesito saber Git?

Sí. Es el único requisito previo. Juju-chu! asume que ya usas Git en el día a día y sabes clonar repositorios, crear ramas, hacer commits, hacer push y abrir pull requests. Buena parte del libro explica Jujutsu comparándolo con Git, así que esas comparaciones solo tienen sentido si Git ya te resulta familiar.

Lo que no necesitas es dominar Git. Si reflog es un misterio para ti y el rebase interactivo te intimida, este libro está escrito precisamente para ti.

¿Tengo que hacer que todo mi equipo cambie de Git a Jujutsu?

No. Jujutsu funciona directamente con un repositorio Git existente, así que puedes incorporarlo a un proyecto en marcha sin cambiar la configuración del resto del equipo. Lo que subes a GitHub son commits normales de Git: tus compañeros siguen usando Git, revisan tus pull requests como siempre y ni siquiera necesitan saber que cambiaste de herramienta.

Por eso, probar Jujutsu implica muy poco riesgo. La decisión es solo tuya y puedes dar marcha atrás cuando quieras. El repositorio Git sigue estando ahí mientras trabajas con Jujutsu, así que puedes ejecutar directamente un comando de git siempre que lo necesites.

¿Necesito Claude Code o Codex?

No. El libro utiliza Claude Code y Codex CLI en los ejemplos prácticos, pero lo que enseña sobre Jujutsu no depende de ninguna de las dos herramientas.

La configuración de Codex se basa en AGENTS.md y skills, convenciones abiertas que Cursor, OpenCode y otros agentes también pueden leer. Por eso, para reutilizar las reglas e instrucciones del libro en otras herramientas, basta prácticamente con cambiar el nombre de un archivo. En realidad, aprendes a enseñar a un agente a usar Jujutsu en lugar de Git, y ese conocimiento te servirá con distintas herramientas.

¿Qué versión de Jujutsu cubre el libro?

Jujutsu v0.45.1, publicada en septiembre de 2026. Todas las funcionalidades y limitaciones descritas en el libro corresponden a esa versión.

Jujutsu aún no ha llegado a la versión 1.0 y evoluciona rápidamente, así que algunos detalles cambiarán inevitablemente. Pero el libro va más allá de los comandos: profundiza en la filosofía de diseño y el modelo mental de Jujutsu, y explica cómo aplicarlos al desarrollo con agentes de IA. Esos son los aspectos más difíciles de aprender a partir de las notas de versión y deberían seguir siendo útiles durante muchas versiones más.

¿Se actualizará el libro?

Sí, dentro de ciertos límites. Si algún cambio en Jujutsu hace que las instrucciones del libro dejen de ser correctas, revisaré las secciones afectadas. También corregiré errores y reescribiré cualquier parte que pueda explicarse mejor.

Este es un libro terminado, no una obra de referencia que se amplíe de forma continua. Las actualizaciones mantendrán al día el contenido existente; no van a perseguir cada nueva funcionalidad de Jujutsu ni a reorganizar el libro.

Si compras el libro en Leanpub, recibirás estas actualizaciones sin costo adicional. Por defecto, Leanpub también te avisará por correo cuando se publique una nueva versión. Amazon no te avisará y tampoco hay forma de comprobar desde tu biblioteca de Kindle si existe un archivo más reciente, así que la única opción segura es eliminar el libro y descargarlo de nuevo. La edición en tapa blanda se imprime bajo demanda, por lo que las revisiones se incluirán en los ejemplares que se impriman después de cada actualización.

¿Qué edición me conviene?

PDF y EPUB (Leanpub): tienen un diseño tipográfico cuidado, fuentes incrustadas y están completamente libres de DRM. El PDF conserva íntegro el diseño de cada página, mientras que el EPUB adapta el texto a las pantallas más pequeñas sin sacrificar la tipografía del libro. Si te importa cómo se ve y cómo se lee un libro técnico, o quieres guardar los archivos fuera del alcance de Amazon, esta es la mejor opción para ti.

Kindle (Amazon): la opción adecuada si ya lees habitualmente en la aplicación o en un dispositivo Kindle. El texto se adapta al tamaño de la pantalla, aunque inevitablemente se pierden algunos detalles de la tipografía original.

Tapa blanda (Amazon): 15 × 23 cm, 168 páginas y la única forma de conseguir Juju-chu! en papel.

Si prefieres ver el libro antes de decidir, hay una muestra gratuita de 43 páginas. El botón de la parte superior de esta página abre la muestra aquí mismo, sin necesidad de descargar nada.

Si también quieres saber qué opción me apoya de manera más directa, mi parte de cada venta es ligeramente mayor en Leanpub que en Kindle. Compra donde más te convenga; si no tienes preferencia, ese puede ser el criterio de desempate.