Estaba haciendo unas pruebas de concepto y quería iniciar un nuevo proyecto a partir de una parte concreta de un repositorio. Copiar una carpeta tal cual puede arrastrar el historial y los archivos de control de git, algo que no me interesa. A continuación comparto tres formas sencillas de extraer solo una subcarpeta de un repositorio sin traer el .git.
Opción manual
En cualquier repositorio de GitHub puedes descargar el contenido como archivo zip desde la opción Code y luego Download ZIP. Descomprime el zip, copia la subcarpeta que necesitas dentro de tu nuevo repositorio y realiza un git init si aún no lo has hecho. Con eso ya puedes continuar tu desarrollo sin el historial anterior.
Git archive desde terminal
El comando git archive permite extraer archivos de un repositorio remoto sin clonar todo. Puedes conectarte por https o por ssh. Indica el remote, el branch y la ruta de la subcarpeta que quieres traer; la salida la enviamos a tar para extraer directamente en la carpeta actual.
https: git archive --remote=https://github.com/dwildt/gosandbox.git main vibe-certificados | tar -x
ssh: git archive --remote=git@github.com:dwildt/gosandbox.git main vibe-certificados | tar -x
Via curl
También puedes descargar un tar comprimido del branch y extraer solo la subcarpeta deseada con strip-components. Ejemplo en un repo público:
curl -L https://github.com/dwildt/gosandbox/archive/main.tar.gz | tar -xz --strip-components=1 gosandbox-main/vibe-certificados
Si el repositorio es público, este método funciona sin autenticación. Para repos privados necesitarás un token o acceso ssh. En mi caso, el objetivo era tomar el contenido del test llamado vibe-certificados y convertirlo en un nuevo repositorio independiente. Cualquiera de las tres opciones cumple el objetivo sin arrastrar el historial.
Consejos prácticos
1. Asegúrate de estar en una carpeta vacía antes de extraer con tar si no quieres mezclar archivos. 2. Si vas a reutilizar esta técnica a menudo, crea un pequeño script que reciba repo, branch y ruta para automatizar el proceso. 3. Una vez extraído, ejecuta git init, crea tu primer commit y define tu nuevo remoto.
Cómo encaja esto en flujos de trabajo reales
Estas técnicas son muy útiles para crear plantillas y boilerplates, separar módulos de un monorepo o simplificar pruebas de concepto. Facilitan la estandarización y la automatización, especialmente cuando trabajas con equipos que comparten assets comunes.
En Q2BSTUDIO ayudamos a equipos a acelerar su entrega con buenas prácticas de ingeniería y repositorios organizados, ya sea para aplicaciones a medida y software a medida, o para escalar la productividad mediante automatización de procesos y plantillas reutilizables. Además, integramos inteligencia artificial e IA para empresas con agentes IA, cuidamos la ciberseguridad desde el diseño, trabajamos con servicios cloud AWS y Azure, y potenciamos tus datos con servicios inteligencia de negocio y Power BI.
Si buscas un socio que combine desarrollo pragmático con innovación, Q2BSTUDIO es tu equipo. Podemos ayudarte a definir repositorios base, pipelines de CI, seguridad y observabilidad desde el inicio, para que tu producto crezca sólido y seguro con prácticas modernas de ingeniería y un enfoque de entrega continua.