Volver a la sesión de tu agente desde el grafo: GitLens 19 ata Claude Code a cada worktree
Si corres más de un coding agent a la vez, ya conoces el modo de falla. Tres worktrees, tres terminales, tres sesiones, y veinte minutos después estás clickeando pestañas para averiguar cuál estaba haciendo la migración y cuál está esperando que le contestes una pregunta. El trabajo no se perdió: simplemente no lo encuentras.
GitLens 19, liberado el 12 de agosto y anunciado en el blog de GitKraken al día siguiente, apunta justo ahí. El titular es un Commit Graph reconstruido, ahora primero en el sidebar y presentado como la superficie única donde revisas, compones, comparas, rebasas y resuelves conflictos. GitKraken lo dice sin vueltas: “The Commit Graph is now the workbench for modern development workflows” — el Commit Graph pasa a ser el banco de trabajo de los flujos de desarrollo modernos.
El rediseño es real, pero no es la parte que te cambia el día. La parte que te cambia el día es un click derecho sobre una fila de working changes: Resume Agent Session. Eliges la sesión de agente asociada a ese worktree y vuelves a estar dentro, sin salir a buscar en qué terminal quedó.
Esta guía cubre cómo dejarlo funcionando, qué te muestra el grafo mientras el agente trabaja y —porque GitKraken no lo pone en un solo lugar— qué funciones son gratis, cuáles necesitan plan pago y cuáles siguen etiquetadas como Preview.
Lo que necesitas antes de empezar
- GitLens 18 o posterior (el tracking de sesiones de agente llegó en 18; en 19 es donde se integra al grafo).
- Uno de los editores soportados: VS Code, Cursor, Windsurf, Trae o Kiro.
- Una cuenta de GitKraken. Es gratuita, pero las funciones de sesiones de agente están marcadas como Preview, y Preview exige cuenta.
- Claude Code instalado. Esto importa más de lo que parece: mira la sección siguiente.
La limitación que conviene entender primero
El monitoreo de estado en vivo dentro de GitLens funciona solo con Claude Code, a través de hooks que GitLens instala y administra por su cuenta. Así está dicho, sin ambigüedad, en la documentación de agentes de GitKraken.
El post del blog es más laxo: dice que GitLens puede despachar trabajo a los chats del IDE soportados, a la extensión de Claude Code y a los CLI agents detectados. Las dos cosas pueden ser ciertas a la vez —despachar trabajo hacia un agente y observar su estado en tiempo real son capacidades distintas—, pero si corres Codex CLI, Gemini CLI o el agente de Cursor en paralelo con Claude Code, no esperes verlos encenderse en el grafo. Hoy no va a pasar.
Entonces: este es un flujo de Claude Code. Si ese es tu stack, es un buen flujo.
Paso 1 — Instalar los hooks de Claude Code
GitLens ofrece la instalación en tres lugares, y cualquiera de ellos hace exactamente lo mismo:
- el header del Commit Graph
- el banner de la vista Agent Sessions en el sidebar
- el menú Integrations
Aceptas y GitLens escribe sus hooks en la configuración de Claude Code. Desde ese momento, al grafo le avisan cuándo arranca una sesión, cuándo termina y cuándo está esperando algo de ti.
Si quieres salir, la Command Palette tiene una salida explícita: GitLens: Uninstall Claude Code Hooks. Vale la pena saberlo antes de instalar y no después — unos hooks que escriben en la configuración de un agente son justo el tipo de cosa que uno quiere poder revertir cuando se le antoje.
Paso 2 — Un worktree por tarea
Todo esto está construido sobre worktrees, así que si todavía corres agentes dentro de un solo clone, este es el cambio que hace funcionar al resto.
git worktree add ../myapp-auth-refactor -b auth-refactor
git worktree add ../myapp-billing-fix -b billing-fix
Dos directorios, dos branches, un repositorio. Cada agente se queda con su propio working tree y deja de pisar los cambios sin commitear del otro.
GitLens 19 agrega una barra de acceso rápido que lista los worktrees con cambios sin commitear, así ves de un vistazo cuáles están sucios sin abrir cada uno. También sumó un buscador de referencias por type-ahead: presionas / dentro del grafo y saltas a un branch, un tag o un worktree por nombre.
Paso 3 — Levantar un agente dentro del worktree
Abre el worktree en tu editor e inicia Claude Code ahí como lo harías siempre. Los hooks se encargan del registro; no tienes que anunciarle la sesión a GitLens.
La asociación que arma GitLens es entre la sesión y el worktree donde corre. Ese es todo el diseño: el worktree como unidad de trabajo paralelo, y la sesión de agente como algo que cuelga de él.
Paso 4 — Leer el grafo mientras corre
El Commit Graph muestra una fila de work-in-progress por cada worktree conectado — el estado sin commitear como fila de primera clase, no como algo que sales a buscar. Con los hooks instalados, esas filas llevan el estado del agente en cuatro valores:
- Running — animación de pulso, el agente está trabajando
- Waiting for Input — una animación deliberadamente insistente; es la que te cuesta tiempo cuando se te pasa
- Idle — conectado, sin hacer nada
- Completed — terminó, listo para que revises
“Waiting for Input” es el estado que justifica la función. Con dos o tres sesiones en paralelo, lo que realmente se come la tarde es un agente que hizo una pregunta hace cuarenta minutos en una terminal que no estabas mirando.
Paso 5 — Resume Agent Session
Click derecho sobre la fila de working changes de un worktree. Te aparece la lista de sesiones de agente asociadas a ese worktree: reabres una que está viva, o retomas una anterior.
Eso es toda la función, y es chica a propósito. El grafo que ya tienes abierto se convierte en el índice de dónde están tus agentes. Dejas de mantener ese índice en la cabeza.
Qué es gratis, qué es Pro y qué es Preview
GitKraken reparte este dato en notas al pie de las release notes, así que acá está junto.
Sin restricción de tier:
- la reconstrucción del Commit Graph y su nuevo motor de renderizado
- soporte de stacked pull requests y el nuevo panel de Pull Requests
- verificación de commits firmados con SSH
- selección de modelo de IA por función
- todas las mejoras de navegación y visualización
Requiere GitLens Pro (trial o plan pago, para uso sobre repos privados):
- Automatic Rebase — el modo de punta a punta donde cada paso en conflicto se resuelve, se stagea y se continúa automáticamente, con un panel Resolve en vivo que muestra estrategia, confianza y razonamiento
- detección de conflictos en los pull previews
Marcado como Preview (requiere cuenta de GitKraken):
- las mejoras de sesiones de agente, incluido todo lo que cubre esta guía
- la consulta al repositorio para resolución de conflictos con IA — donde el modelo puede leer el archivo, hacer blame o log de las líneas involucradas, buscar otros usos de los símbolos y diffear ambos lados antes de elegir una resolución
Ahora lee esa lista contra el titular. La promesa es una superficie única donde pasa todo; en la práctica la superficie está partida en tres tiers, y la pieza más vistosa —un rebase que se maneja solo hasta el final— es la paga. El flujo de agentes y worktrees, que es la razón para que te importe este release si corres Claude Code, es gratis con cuenta y está etiquetado como Preview.
Un setting que conviene conocer si activas la consulta al repositorio: gitlens.ai.exclude.files aplica a todas las lecturas que hace la IA, no solo a esa función. Si hay archivos que no quieres que un modelo abra, ahí es donde se dice.
El resto de 19.0, en corto
La reconstrucción del grafo no es cosmética: GitKraken reporta carga, renderizado, actualización y scroll más rápidos en repositorios grandes, menor uso de memoria y mejor accesibilidad por teclado y lector de pantalla. Lo concreto: agrupación de columnas, plegado de lanes para colapsar el historial que no te interesa, colores de lane perceptualmente uniformes para temas oscuros y de alto contraste, reference pills coloreadas por rol para HEAD, upstream y merge targets, una columna Changes nueva con los diffstats del commit, agrupación sticky por fecha y ? para la referencia completa de teclado.
También entra en este release: stacked pull requests de GitHub entendidos como una unidad, con badges de capa y merge stack-aware vía la API de GitHub; la composición de commits mudada del editor propio al panel de detalles del grafo, con reordenamiento por drag; selección de modelo por función, para que componer commits, revisar cambios y resolver conflictos usen modelos distintos; soporte de Gemini 3.6 Flash y 3.5 Flash-Lite; worktrees bloqueados con comandos de Unlock; Apply/Pop Stash sobre las filas de WIP; y una página de settings rediseñada con una sección Agents propia.
¿Vale la pena instalarlo hoy?
Si corres Claude Code en paralelo sobre worktrees, sí — y el setup es instalar un hook más los worktrees que ya deberías estar creando. Lo que ganas no es velocidad: es dejar de buscar. Qué agente está en qué branch, y cuál te está esperando.
Si corres cualquier otro agente, instala 19 por la reconstrucción del grafo y el soporte de stacked PRs, y vuelve a mirar el monitoreo más adelante. Nada de esto alcanza todavía a tus sesiones de Codex o Gemini.
Y si lo que te llamó la atención fue el rebase automático, cotízalo antes de planificar con él. Ese es Pro.
¿Tú ya separas cada agente en su propio worktree, o sigues corriendo todo en un solo clone?