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

Optimiza tu productividad compartiendo documentos entre worktrees de forma fácil con dot-claude-sync. Aprende cómo hacerlo de manera sencilla y eficiente.

16 nov 2025 • 4 min read • Q2BSTUDIO Team

Compartir documentos entre worktrees con dot-claude-sync
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.

A BREAK?

Play for a moment before you go

OUR SERVICES

How we can help you

Artificial intelligence

AI agents, chatbots, and intelligent assistants that automate tasks and serve your customers 24/7 to improve the efficiency of your business.

More info

Software Development

Web, mobile, and desktop applications, intranets, e-commerce, SaaS, and management platforms designed for your company's specific needs.

More info

Cloud services

Migration, infrastructure, managed hosting, high availability, and security on Microsoft Azure and Amazon Web Services to help your business scale without limits.

More info

Cybersecurity and pentesting

Security audits, penetration testing and protection of applications, data and infrastructure on-premise and cloud, with ethical hacking and regulatory compliance.

More info

Business Intelligence

Dashboards and data analysis with Power BI: we integrate your sources, design dashboards and KPIs and turn your data into decisions.

More info

Process automation

We automate repetitive tasks and connect your applications with n8n, Power Automate, Make, and RPA, eliminating manual work and increasing productivity.

More info

Training for Companies

We train your teams in technology with criteria: web development, databases, Git, best practices and security, automation with n8n, artificial intelligence for companies and creation of AI solutions with Azure AI Foundry.

More info

Code Auditing

We audit the code that you, your team or an AI create: we tell you what is good and what to improve, we secure it and make it ready for production, web or app.

More info

AI Image Generation

We create for you the images that your business needs with artificial intelligence: product, networks, advertising, illustration and avatars. You tell us what you want and we deliver it ready to use.

More info

AI Video Generation

We create videos with artificial intelligence for you: promotional, networking, virtual presenters, dubbing and animations. You tell us the idea and we will deliver it assembled and ready to publish.

More info

AI Conversational Avatars

We create conversational avatars with AI – digital humans with a face and voice – that serve your customers and teams with the knowledge of your company, on your website, interactive monitors, WhatsApp or Teams.

More info

Online Marketing and AI

Google Ads, Meta Ads, LinkedIn Ads and AI Engine Positioning (GEO/AEO): we attract customers and make your brand appear where they search for you, also on ChatGPT, Gemini and Perplexity.

More info

Do you have a project in mind?

Tell us your vision and we'll turn it into a software solution. Whatever the scope, we make your idea real.

Live Chat