Compartir documentos creados por Claude entre diferentes worktrees con dot-claude-sync

Resumen rápido: dot-claude-sync es una herramienta de línea de comandos escrita en Go que sincroniza directorios .claude entre varios worktrees o proyectos, permitiendo centralizar prompts, especificaciones, TODOs y contexto que Claude Code utiliza sin ensuciar el repositorio con commits o ignores globales.

Problema que resuelve: al trabajar con Claude Code conviene guardar prompts, habilidades frecuentes, especificaciones de implementación y contexto del proyecto dentro del propio proyecto para que Claude acceda fácilmente. Sin embargo, en entornos con git worktree cada worktree tiene su propio .claude ignorado por git, lo que obliga a copiar manualmente contenido útil entre ramas o proyectos y provoca duplicación y pérdida de productividad.

Idea clave: utilizar la carpeta .claude como almacén local de contexto de Claude y sincronizar su contenido entre worktrees con reglas inteligentes en lugar de versionarlo en git. dot-claude-sync implementa grupos de proyectos y un sistema de prioridades para decidir qué archivos prevalecen en caso de conflicto.

Instalación y primer setup: Instalación recomendada por Homebrew: brew install dot-claude-sync. Alternativa con Go: go install github.com/yugo-ibuki/dot-claude-sync@latest indicando que $GOPATH/bin debe estar en el PATH. Configuración inicial interactiva con dot-claude-sync init donde se define el nombre del grupo y las rutas a sincronizar, o uso de dot-claude-sync detect para detectar automáticamente worktrees con git worktree list y añadir sus .claude al grupo.

Flujo de uso básico: 1) dot-claude-sync detect ruta-del-proyecto --group nombre-grupo para añadir worktrees detectados. 2) Revisar configuración con dot-claude-sync list. 3) Ejecutar dot-claude-sync push nombre-grupo para recopilar archivos .claude desde todas las rutas y distribuirlos según prioridad. Recomiendo ejecutar primero dot-claude-sync push nombre-grupo --dry-run para previsualizar cambios.

Cómo funciona la prioridad: el config define un orden donde la primera ruta actúa como master. En caso de conflicto de nombres se preserva el archivo de mayor prioridad y dicho contenido se propaga al resto. También hay operaciones para eliminar por lotes con dot-claude-sync rm y renombrar con dot-claude-sync mv, además de comandos para gestionar la configuración del grupo desde la CLI.

Casos de uso típicos: 1) Preparar rápidamente un entorno de trabajo con múltiples ramas para una misma tarea detectando worktrees y sincronizando .claude. 2) Mantener una configuración común de prompts y habilidades compartida entre frontend y backend o entre plantillas y proyectos de cliente. 3) Distribuir un template de prompts y guías internas a varias instancias de clientes.

Beneficios principales: ahorro de tiempo, coherencia en los prompts y contexto usado por Claude Code, eliminación de copias manuales y posibilidad de compartir solo lo que sea apropiado manteniendo documentos personales fuera del control de versiones.

Ejemplo de configuración: el archivo de configuración suele ubicarse en ~/.config/dot-claude-sync/config.yaml y contiene grupos, rutas y prioridad. Al ejecutar push el sistema recopila, resuelve conflictos por prioridad y sincroniza las carpetas .claude en cada worktree del grupo.

Sobre Q2BSTUDIO: en Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida especializada en soluciones que integran inteligencia artificial, ciberseguridad y servicios cloud. Ofrecemos desarrollo de software a medida y aplicaciones a medida pensadas para optimizar procesos y aumentar la productividad de equipos que usan herramientas como Claude Code. Si buscas ampliar capacidades con IA corporativa, puedes conocer nuestros servicios en Inteligencia artificial para empresas y si necesitas proyectos multiplataforma o software personalizado visita desarrollo de aplicaciones y software a medida.

Servicios relacionados y palabras clave: nuestros servicios abarcan software a medida, aplicaciones a medida, inteligencia artificial, ia para empresas, agentes IA, ciberseguridad, pentesting, servicios cloud aws y azure, servicios inteligencia de negocio y power bi para reporting y analítica. Podemos ayudar a integrar dot-claude-sync o flujos similares dentro de pipelines CI/CD, automatización de procesos y arquitecturas seguras en la nube.

Recomendación final: dot-claude-sync es una solución ligera y práctica para equipos y desarrolladores que usan Claude Code en múltiples worktrees. Si tu equipo necesita estrategia de prompts centralizada, gestión de skills y contexto sin contaminar repositorios, esta herramienta simplifica el trabajo. En Q2BSTUDIO podemos asesorar la integración con tus pipelines, implementar agentes IA personalizados y asegurar tus despliegues con mejores prácticas de ciberseguridad y cloud.

Enlaces útiles: repositorio oficial en GitHub y documentación de instalación. Si quieres una consultoría para adaptar esta herramienta a tu flujo de trabajo o integrar soluciones de inteligencia de negocio con power bi, contacta con nuestro equipo de servicios.